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INTRODUZIONE 

Era una notte buia e tempestosa del 1 970, o almeno penso che lo fos- 
se, quando Edgar Frank Codd incominciò a pensare che il modo giu- 
sto per gestire dei dati era quello di adottare un modello relaziona- 
le, immagazzinando varie informazioni suddivise per tabelle e or- 
chestragli tramite un linguaggio (SQL). Codd è quello che viene ri- 
conosciuto come il padre del database relazionale, perché prima di 
lui erano presenti altri modelli con i quali venivano rappresentate le 
informazioni. Il modello relazionale è quello che, col passare degli an- 
ni, ha avuto più successo nel campo dell'informatica ed è stato pia- 
no piano adottato dalle principali software house (Oracle & friends) 
come modello di riferimento per i loro prodotti. Il database è una di 
quelle entità all'interno dei nostri programmi che dobbiamo sempre 
gestire in qualche maniera. Ogni programma manipola al suo inter- 
no dei dati e nella maggior parte dei casi il database è utile per me- 
morizzare e ricercare informazioni necessarie al nostro programma. 
Specialmente quando dobbiamo realizzare applicazioni commerciali 
i database offrono una serie di caratteristiche che possono innalza- 
re molto l'affidabilità dei nostri prodotti quindi è importante capire 
quali siano i diversi modi in cui possiamo "dialogare" con queste 
entità. 

TOOL 

All'interno di questo libro vedremo come poter realizzare applica- 
zioni Java che gestiscono i propri dati utilizzando il database. Come 
database di riferimento, che vedremo quindi in diverse configura- 
zioni, è stato scelto MySQL, ottimo database utilizzato in diversi am- 
biti e ultimamente acquisito da SUN Microsystems. Vi consiglio quin- 
di di scaricare i seguenti tool per provare i vari esempi che saranno 
riportati all'interno del libro 
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• MySQL Community Server 5.0 - 

• MySQL GUI Tools: una serie di tool grafici che ci permettono di ge- 
stire al meglio il nostro database MySQL - 
http://dev.mysql.eom/downloads/gui-tools/5.0.html 

La natura multipiattaforma di Java ci permette poi di utilizzare diver- 
si database con poche modifiche alla configurazione del nostro codi- 
ce, quindi altri database che possono essere utilizzati sono ad esem- 
pio PostgreSQL (http://www.postgresql.orgl) o Oracle 
(http://www.oracle.coml). 

CAPITOLI 

Questo libro cerca di introdurre il lettore in diverse tecnologie che pos- 
sono essere utilizzate con Java per gestire un database. I capitoli so- 
no così strutturati: 

1. Introduzione 

2. JDBC: L'API standard Java per collegarsi ad database 

3. Hibernate: Famoso tool di ORM (Object Relational Mapping) che 
permette di ragionare in ottica Object Oriented quando realizziamo le 
nostre applicazioni 

4. iBatis: Altro famoso progetto che si prefigge il compito di essere 
una sorta di middleware, di "man in the middle" tra la nostra appli- 
cazione Object Oriented e il database 

5. db4o: Un database Object Oriented, non relazionale, che offre quin- 
di agli sviluppatori un nuovo modo di considerare il database 

6. Altre tecnologie 

Bisogna sicuramente capire che ognuno di questi capitoli potrebbe 
richiedere un libro a sé stante, visto che stiamo parlando di tecnolo- 
gie molto utili ma che, come ogni cosa utile, richiedono talvolta lun- 
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ghe discussioni ed approfondimenti per essere utilizzati al meglio. 
In questo libro avremo sicuramente modo di vedere come configu- 
rare ed utilizzare questi strumenti, ognuno con peculiarità diverse 
che possono essere proprio quelle di cui siamo alla ricerca quando 
dobbiamo realizzare un progetto software. Avremo modo di vedere 
come alcuni progetti cercano di risolvere l'Impedance Mismatch, ov- 
vero il problema classico che viene generato nel momento in cui pro- 
viamo a mappare delle entità Object Oriented in un contesto relazionale. 

AUTORE 

Federico Paparoni è un Analista Programmatore e per lavoro si occupa 
principalmente delle piattaforme JavaEE e JavaME. Ha scritto diver- 
si articoli sulla programmazione e gestisce JavaStaff.com, portale per 
la divulgazione di articoli e novità riguardanti il mondo Java. Per que- 
stioni relative al libro può essere contattato all'indirizzo email fe- 
derico.paparoni@javastaff.com 
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La SUN fin dalle prime versioni di Java ha portato avanti un API che per- 
mette alle applicazioni scritte in questo linguaggio di avere un livello 
di astrazione uniforme verso i database: JDBC. Questa API, il cui nome 
in realtà non è secondo i progettisti SUN un acronimo di Java Databa- 
se Connectivity, è stata inclusa nel JDK a partire dalla versione 1.1, ca- 
ratterizzando fin dall'inizio questo linguaggio come multipiattaforma 
anche per quanto riguardava la connessione al database. Infatti, attra- 
verso JDBC, vengono dati allo sviluppatore principalmente 3 strumen- 
ti che possono essere utilizzati allo stesso modo con tutti i database 

• Una connessione verso il database in questione 

• La possibilità di inviare dei comandi SQL 

• Ricevere una risposta dal database che può contenere dei dati 

Basandosi sulla generalizzazione di questi concetti e su una serie di dri- 
ver differenti per ogni diverso database, JDBC ci permette dalla nostra 
applicazione Java di gestire completamente tabelle, query, sequenze e 
quant'altro relativo al mondo dei database. Questa omogeneità di API 
viene resa possibile attraverso dei driver che da una parte implementa- 
no le interfacce definite all'interno di JDBC. Dall'altra gestiscono la con- 
nessione verso il database, trasformando le chiamate JDBC in chiama- 
te verso il database utilizzando il rispettivo protocollo. In questo modo 
abbiamo la possibilità di avere dal punto di vista della programmazio- 
ne una sola interfaccia nota da gestire, quella JDBC e possiamo cambia- 
re il database semplicemente cambiando il driver che leghiamo alla no- 
stra applicazione. I driver JDBC possono essere di diverse tipologie, co- 
me quelle che vengono riportate qui di seguito: 

• Tipo 1 . Bridge JDBC-ODBC: Si tratta di un driver da utilizzare nel ca- 
so in cui non sia stata realizzata una vera e propria implementazio- 
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ne JDBC verso un certo database e quindi si utilizza questo "driver- 
ponte" che converte le chiamate JDBC in ODBC (Open Database 
Connectivity), una tecnologia simile ma più vecchia e realizzata so- 
litamente utilizzando linguaggi come C/C++ 

• Tipo 2. API Native: In questo caso le chiamate JDBC non vengono tra- 
dotte in ODBC ma vengono utilizzate delle API native realizzate ap- 
positamente per il database. Il tipo 2 è più prestante del tipo 1 , an- 
che se ha come svantaggio il fatto di dover utilizzare per forza il 
client proprietario del database che fornisce queste API native. 

• Tipo 3. Driver di rete: Questi driver, rispetto ai precedenti, hanno il van- 
taggio di essere scritti totalmente in Java e di utilizzare un midd- 
leware per effettuare le chiamate, che nel caso di una LAN non con- 
gestionata potrebbe essere un vantaggio. 

• Tipo 4. Driver nativo in Java: L'ultima tipologia di driver è quello che 
nella maggior parte dei casi risulta essere il migliore perché è realiz- 
zato totalmente in Java e trasforma le chiamate JDBC direttamente 
nel protocollo del database, quindi permette un collegamento di- 
retto senza bisogno di middleware o client installati. 

Attualmente JDBC è arrivato alla versione 4.0, introducendo pian pia- 
no sempre delle interessanti novità. A partire dalla versione 3.0 tutto 
le decisioni e lo sviluppo relativo a JDBC viene effettuato tramite JCP 
(Java Community Process, per maggiori informazioni http://jcp.org/). 
Le specifiche realizzate in questo modo sono quelle relative a JDBC 3.0 
(JSR 54), il Rowset (JSR 1 1 4) e JDBC 4.0 (JSR 221 ). Tendenzialmente, per 
quanto riguarda i driver, sono direttamente coloro che realizzano il da- 
tabase a fornire un'implementazione JDBC compliant. In questo caso bi- 
sogna vedere a quale versione di JDBC aderiscono questi driver per sa- 
pere le diverse opzioni che possono essere utilizzate all'interno dei no- 
stri programmi. Inoltre driver diversi potrebbero anche avere prestazio- 
ni differenti. Per esempio, insieme alla versione 8.2 di PostgreSQL ven- 
gono distribuite 4 differenti versioni di driver da utilizzare con la nostra 
applicazione. Per entrare nel vivo delle API JDBC e incominciare a capi- 



io 



I libri di ioPROGRAMMo/Java e Database 



Capitolo I 



JDBC 



JAVA 

E DATABASE 



re qualcosa, dobbiamo prima di tutto vedere come è possibile ottene- 
re una connessione verso il nostro database. 



DRIVERMANAGER 

JDBC ci permette di avere un'unica API per gestire nello stesso modo di- 
verse tipologie di database. Il nostro programma deve comunque spe- 
cificare qualche informazione per comunicare a JDBC quale è il databa- 
se che vogliamo utilizzare, dove si trova, come è possibile accedere. 
Fornendo queste informazioni potremo poi ottenere un oggetto ja- 
va, sql. Connection, quello che ci permette di avere/settare informazio- 
ni sulla connessione verso il database ed inviare successivamente dei ve- 
ri e propri comandi SQL. Uno dei modi possibili per ottenere questo og- 
getto Connection è quello di utilizzare DriverManager, una classe che 
attraverso dei metodi getConnection() permette di ottenere questa 
connessione al database. Chiaramente questa classe deve avere 
l'informazione relativa anche al driver che vogliamo utilizzare. Per fare 
ciò dobbiamo caricare la classe relativa presente nel driver che imple- 
menta l'interfaccia java. sql. Driver, come riportato di seguito 

Class.forName("org.postgresql. Driver"); 

Questa, a sua volta, effettua la registrazione del driver sul DriverMana- 
ger utilizzando il metodo statico regìsterDriverQ. Quindi, una volta che 
abbiamo scritto il precedente comando noi abbiamo caricato il driver e 
dobbiamo soltanto preoccuparci di fornire al DriverManager le altre 
informazioni necessarie per ottenere la connessione. Qui di seguito è pos- 
sibile vedere un primo esempio dove viene ottenuta una Connection 
che punta al nostro database. 

package it.ioprogrammo.librodb; 

import java.sql. Connection; 
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import java.sql.DriverManager; 
import java.sql.SQLException; 
import java.sql.DatabaseMetaData; 



public class TestConnection { 



public static void main(String a[]) throws Exception { 
Class.forName("org.postgresql. Driver"); 
String uri = "jdbc:postgresql:libro"; 
Connection connection = DriverManager.getConnection(url, 

"postgres", "postgres"); 
DatabaseMetaData metadata=connection.getMetaData(); 
String driver=metadata.getDriverName()+" 

"+metadata.getDriverVersion(); 

String urlconn=metadata.getURL(); 

String funzioni=metadata.getStringFunctions(); 

boolean supportaSP=metadata.supportsStoredProcedures(); 

boolean supportaT=metadata.supportsTransactions(); 

connection.close(); 

System.out.println( " Driver: " +driver); 
System.out.println("URL: "+urlconn); 
System.out. P rintln("Funzioni presenti: ".funzioni); 
System.out.println("Supporta Stored Procedures: "+supportaSP); 
System.out.println("Supporta transazioni: "+supportaT); 

} 



La connessione viene ottenuta fornendo uri, username e password. 
In questo caso stiamo parlando di URL JDBC, ovvero stringhe che iden- 
tificano il nostro database utilizzando la struttura seguente 
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e comunicando quindi al nostro DriverManager quale driver utilizzare, 
perché ogni driver che si registra gestisce diverse tipologie di uri. Quin- 
di quando noi passiamo al DriverManager un certo uri, questo interro- 
ga la lista dei driver che ha registrato e vede quale utilizzare per otte- 
nere una connessione. All'interno dell'URL JDBC è possibile anche inse- 
rire l'host di destinazione, la porta e lo schema da utilizzare all'interno 
del database. Per quanto riguarda questa informazione potete rivol- 
gervi alla documentazione che viene fornita insieme al driver che dove- 
te utilizzare (chiaramente variano rispetto al database utilizzato e al 
driver JDBC). Ottenuta una Connection la utilizziamo subito per avere 
qualche informazione sul nostro database. Per fare ciò abbiamo biso- 
gno di DatabaseMetadata che ci permette di sapere molte cose, ad 
esempio le varie feature che vengono supportate. Di seguito trovate 
l'output del programma precedente 



s 



Driver: PostgreSQL Native Driver PostgreSQL 8.2 JDBC2 with NO SSL 

(build 505) 

URL: jdbcpostgresqklibro 

Funzioni presenti: ascii,char,concat,lcase,left,length, 

ltrim,repeat,rtrim,space,substring,ucase,replace 
Supporta Stored Procedures: true 
Supporta transazioni: true 

In questo caso abbiamo a che fare con PostgreSQL 8.2, altro famoso da- 
tabase opensource, il quale supporta sia le transazioni che le stored 
procedure. Se avessimo voluto utilizzare MySQL, database che verrà 
utilizzato in questo libro anche per altri esempi, avremmo dovuto sicu- 
ramente cambiare la stringa di connessione JDBC nella seguente 

jdbc:mysql://localhost:3306/librodb 

Reperite le informazioni, passiamo, quindi, alla chiusura della connes- 
sione, cosa che deve essere sempre fatta come una buona regola di 
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programmazione, sia perché libera memoria sia perché si liberano con- 
nessioni verso il database senza lasciarle appese 

connection.closeO; 

La classe Connection mette a disposizione anche altri interessanti me- 
todi che possiamo utilizzare per gestire la connessione con il database. 
Il metodo setTransactionlsolationQ permette, ad esempio, di definire 
il livello di isolamento relativo alle transazioni che possiamo gestire at- 
traverso JDBC. I livelli che possono essere definiti sono i classici quattro 
relativi al mondo dei database 

• TRANSACTION_READ_COMMITTED: Vengono prevenute le letture 
sporche. Possono comunque essere presenti delle letture fantasma 
o letture non ripetibili 

• TRANSACTION_READ_UNCOMMITTED: Possono essere presenti 
letture sporche, letture fantasma e letture non ripetibili 

• TRANSACTION_REPEATABLE_READ: Limita i possibili problemi la- 
sciando le letture fantasma 

• TRANSACTION_SERIALIZABLE: Elimina tutti e 3 i problemi relativi alle 
letture 

Oltre a questo possiamo disabilitare l'autocommit del nostro database, 
gestendo una vera e propria transaziona relativa ai vari comandi che 
vogliamo inviare al database. 

connection. setAutoCommit(false); 



try { 

//QUI EFFETTUIAMO OPERAZIONI DI CUI 



//NON VIENE FATTO IL COMMIT IMMEDIATAMENTE 
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//ALLE FINE EFFETTUIAMO IL COMMIT 



connection.commitO; 

} 

catch(SQLException e) { 
connection. rollback(); 

} 



Come ogni altra API java, anche con JDBC abbiamo la classica gestio- 
ne dei problemi con le Exception. Una delle eccezioni classiche che avre- 
mo modo di vedere utilizzando JDBC è SQLException, che contiene al 
suo interno dei messaggi informativi inviati dal database sottostante, il 
quale ci spiega per quale motivo la nostra applicazione ha riportato un 
errore. Nel caso in cui i comandi che stiamo inviando verso il database 
provochino un SQLException allora il nostro blocco try-catch ci permet- 
te di non effettuare nessuna commit ma di effettuare il rollback di tut- 
te le operazioni della nostra transazione. In aggiusta a questo mecca- 
nismo di commit/rollback, JDBC ci permette di salvare diversi step all'in- 
terno della transazione che stiamo gestendo. Questo è possibile utiliz- 
zando il metodo setSavePointO di Connection che ci restituisce un og- 
getto SavePoìnt relativo al momento della transazione in cui siamo. 
Successivamente possiamo ripristinare la nostra transazione tornando 
direttamente al punto che abbiamo salvato, utilizzando il metodo roll- 
back() di Connection che prende come parametro un SavePoint. 



DATASOURCE 

Il DriverManager non è l'unico modo in cui possiamo ottenere una Con- 
nection JDBC per dialogare con il database. L'interfaccia DataSource, 
definita nel package javax.sql, permette di ottenere una connessione 
tramite JNDI (Java Namingand Directory), definendo ovvero la connes- 
sione al di fuori della nostra applicazione e permettendoci, quindi, di 
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non dover includere nelle nostre applicazioni configurazioni che pos- 
sono poi cambiare. Oltre a questo interessante vantaggio rispetto al 
DriverManager, attraverso il DataSource possiamo utilizzare in manie- 
ra trasparente per il nostro programma le seguenti feature: 

• Connection pooling: La connessione che otteniamo sarà una di 
quelle presenti in un pool di connessioni, in questo modo i tempi di 
attivazione verso il database sono ridotti 

• Transazioni distribuite: La connessione in questo caso può par- 
tecipare ad una transazione distribuita 

Vediamo ora come poter utilizzare un DataSource e come possiamo ot- 
tenere da esso una Connection. La configurazione che viene ora ripor- 
tata riguarda Apache Tomcat, ServIet/JSP container dove possiamo co- 
modamente configurare dei DataSource per le nostre applicazioni 

<Resource name="jdbc/TestDB" auth=" Container" 
type="javax.sql. DataSource" 

maxActive="100" maxldle="30" maxWait=" 10000" 
username="librodb" password=" librodb" 

driverClassName="com.mysql.jdbc.Driver" 
url="jdbc:mysql://localhost:3306/librodb?autoReconnect=true"/> 

Questa configurazione deve essere presente all'interno del file con- 
text.xml oppure all'interno di server. xml, file di configurazione presen- 
ti in Tomcat. In questo modo abbiamo configurato un DataSource che 
può essere richiamato utilizzando il nome jdbc/TestDB. Come potete 
vedere abbiamo dovuto inserire nella configurazione anche l'uri JDBC, 
username e password, in modo tale che quando utilizzeremo questo 
DataSource dal nostro programma dovremo semplicemente richiamar- 
lo attraverso JNDI. Questa configurazione possiamo farla manualmen- 
te o gestirla direttamente dalla console di amministrazione di Tomcat, 
come viene riportato nell'immagine. 
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Figura 1.1: Configurazione DataSource da Tomcat 



Per utilizzare poi questo DataSource dalla nostra applicazione web, 
dobbiamo inserire la risorsa nel file web.xml 



<resource-ref> 

<description>DB Connection</description> 
<res-ref-name>jdbc/TestDB</res-ref-name> 
<res-type>javax.sql.DataSource</res-type> 
<res-auth>Container</res-auth> 

</resource-ref> 
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Una volta che abbiamo queste informazioni configurate possiamo tran- 
quillamente richiamare il DataSource dal nostro programma ed otte- 
nere una Connection per il nostro database. Vediamo quindi una sem- 
plice Servlet, dove abbiamo ridefinito il metodo initQ per vedere se al- 
l'avvio riesce a collegarsi al database tramite il DataSource da noi de- 
finito: 



package it.ioprogrammo.librodb; 
import java. io.*; 
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importjava.net.*; 

import java.sql. Connection; 

import java.sql. SQLException; 



import javax.naming.InitialContext; 
import javax.naming.NamingException; 

import javax.servlet.*; 

import javax.servlet.http.*; 

import javax.sql.DataSource; 

public class ProvaDataSource extends HttpServIet { 

public void init() throws ServIetException { 
Context initContext; 
try{ 

initContext = new InitialContextO; 
Context envContext = 

(Context)initContext.lookup("java:/comp/env"); 
DataSource ds = (DataSource)envContext.lookup("jdbc/TestDB"); 
Connection conn = ds.getConnection(); 
System.out.println(conn.getMetaData().getDatabaseProductName()); 



ex.printStackTrace(); 

} 

} 



I DataSource possono essere definiti in maniera analoga anche su altri 
container diversi da Tomcat. Ad esempio, se dobbiamo utilizzare BEA 
WebLogic per un nostro progetto, possiamo tranquillamente definire 
tutta la configurazione riguardante i DataSource e i pool di connessio- 
ni ad essi associati, direttamente dall'interfaccia di amministrazione, 
come potete vedere dalla figura seguente. 
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Figura 1.2: Configurazione DataSource da BEA WebLogic 



STATEMENT E RESULTSET 

Abbiamo visto come poter ottenere la connessione tramite le API JDBC 
in diversi modi, ora dobbiamo vedere come poter inviare dei comandi al 
database e gestire i risultati. La classe che ci permette di inviare un co- 
mando al database è Statement, una volta che abbiamo una Connec- 
tion si può ottenere nel seguente modo: 

Statement statement = connection. createStatement(); 

Lo Statement può essere usato in 4 diversi modi per inviare delle istru- 
zioni SQL al nostro database, utilizzando 4 diversi metodi che offre gue- 
sta classe: 



• executeQueryO Viene eseguito il comando SQL che è fornito co- 
me argomento al metodo. Questo metodo permette di avere come 
risposta un ResultSet, che è l'insieme dei risultati derivanti dalla no- 
stra query 

• executeUpdateO: Attraverso questo metodo possiamo inviare al 
database quei comandi SQL che non prevedono un insieme di risul- 
tati, ma quelli che riguardano la gestione del database (SQL DDL). 
Questo metodo si utilizza per comandi sql come UPDATE, INSERT, DE- 
LETE e ritorna il numero di righe che sono state interessate dal no- 



I libri di ioPROGRAMMO/Java e Database 



19 



JAVA 
E DATABASE 



JDBC 



Capitolo I 



stro comando 

• execute(): Questo metodo viene utilizzato in quei particolari (e ra- 
ri) casi in cui la risposta al nostro comando SQL può contenere diver- 
se risposte, ovvero diversi oggetti ResultSet. 

• executeBatch(): E' possibile inserire nel nostro Statement una se- 
rie di comandi SQL (INSERT o UPDATE di solito) che possono esse- 
re eseguite in sequenza da JDBC quando richiamiamo questo meto- 
do, che ritorna un array di interi dove vengono specificate per ogni 
comando SQL le righe che sono state modificate tramite esso. 

Se vogliamo quindi creare una nostra tabella tramite JDBC, e incomin- 
ciare ad inserire delle righe, dobbiamo utilizzare il metodo executeUp- 
date(), come potete vedere nell'esempio seguente: 

package it.ioprogrammo.librodb; 

import java.sql. Connection; 
import java.sql. DriverManager; 
import java.sql. SQLException; 
import java.sql. Statement; 
import java.util.logging.Level; 
import java.util.loggin g .Logger; 

public class TestExecuteUpdate { 
public static void main(String a[]) { 
try{ 

Class.forNameC'com.mysql.jdbc.Driver"); 
String uri = "jdbc:mysql://localhost:3306/libro"; 
Connection connection = DriverManager.getConnection(url, "root", 

"mysql"); 



Statement statement = connection.createStatement(); 
String creazioneTabella=" CREATE TABLE 'libro' .'UTENTI' (" + 
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AUTOJNCREMENT," + 
"'NOME' VARCHAR(45) NOT NULL," + 
"'COGNOME' VARCHAR(45) NOT NULL," + 
"'TELEFONO' VARCHAR(45) NOT NULL," + 
"'EMAIL' VARCHAR(45) NOT NULL," + 
"PRIMARY KEY ('ID'))"; 
int risultato=statement.executeUpdate(creazioneTabella); 
Logger.getLogger("TestExecuteUpdate").log(Level.lNFO, "Risultato 

CREATE :"+risultato); 

String inserimentoUtente="INSERT INTO 

'libro' .'UTENTI'(NOME,COGNOME,TELEFONO, EMAIL) " + 
" VALUE5C Federico', 'Paparoni','1234567890','federico.paparoni@javastaff. 

com')"; 

risultato=statement.executeUpdate(inserimentoUtente); 
Logger.getLogger("TestExecuteUpdate").log(Level.lNFO, "Risultato 

INSERT :"+risultato); 

rs.close(); 

connection. close(); 
} catch (SQLException ex) { 

Logger.getLogger("TestExecuteUpdate").log(Level. SEVERE, nuli, ex); 
} catch (ClassNotFoundException ex) { 

Logger.getLogger("TestExecuteUpdate").log(Level. SEVERE, nuli, ex); 

} 



s 



) 



} 



In questo breve esempio abbiamo creato una connessione verso il no- 
stro database MySQL e a partire dalla connessione abbiamo inizializza- 
to uno Statement. Dopo di ciò abbiamo inviato due diversi comandi, 
uno per la creazione della tabella ed il successivo per l'inserimento di una 
entry. Entrambe le operazioni sono state realizzate utilizzando il meto- 
do executeUpdateO di Statement, passando come argomento una 
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stringa con il comando SQL. Passiamo ora al metodo più importante di 
Statement, executeQueryO, che ci permette di avere come risultato un 
insieme di entry relative ad una o più tabelle. ResultSet è la classe che 
mappa questo concetto, permettendoci di avere a disposizioni tutti i va- 
lori restituiti dalla query sotto forma di oggetto Java. Quando richia- 
miamo il metodo executeQueryO ed otteniamo un oggetto ResultSet, 
avremo la risposta alla nostra query inserita in questo oggetto, orga- 
nizzata secondo le righe della selezione che abbiamo fatto. Per questo 
motivo possiamo navigare tutta la risposta riga dopo riga, utilizzando 
l'operatore next() di ResultSet che ci permette di andare avanti nella ri- 
sposta restituita fino al suo completamento: 

Statement statement = connection. createStatement(); 

ResultSet rs = stmt.executeQueryfSELECT ID, NOME, COGNOME FROM 

UTENTI"); 

while (rs.next()) { 

int id = rs.getlntflD"); 

String nome = rs.getString("NOME"); 

String cognome = rs.getFloatfCOGNOME"); 

System. out.println(" UTENTE #" + id + " : " + nome + " " + cognome); 

Come potete osservare, il ciclo while continua fino a quando è presen- 
te una riga nel nostro ResultSet, cioè fino a quando non lo abbiamo vi- 
sitato tutto in una determinata direzione. All'interno del ciclo andiamo 
ad estrapolare i dati utilizzando i metodi getXXXà ResultSet. Questi me- 
todi vengono utilizzati per effettuare il giusto cast tra il tipo di dato pre- 
sente sul database e quello che noi dobbiamo importare nella nostra ap- 
plicazione Java. Come parametro può essere passato il nome della co- 
lonna che ci interessa o la sua posizione relativa all'interno della query 
(ad esempio 2 se la colonna è la seconda nella SELECT). Quando andia- 
mo ad utilizzare questi metodi dobbiamo sapere bene quale tipo di da- 
to stiamo trattando, altrimenti possiamo sollevare delle eccezioni. Result- 
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Set è un oggetto che ha acquisito con le varie versioni di JDBC diverse 
feature interessanti, che andiamo ora ad analizzare. Come abbiamo già 
detto, dobbiamo analizzare le informazioni contenute nel ResultSet pro- 
cedendo riga per riga, grazie al metodo next() che ci permette di salta- 
re alla riga successiva. Proprio su questa forma di gestione dei dati (a ri- 
ghe con avanzamento tramite un cursore) che otteniamo come risposta 
alla nostra query possiamo avere a che fare con diverse tipologie di Re- 
sultSet: 

• TYPE_FORWARD_ONLY: E' possibile analizzare i dati restituiti 
andando in una sola direzione, cioè muovendosi riga per riga sen- 
za poter tornare indietro 

• TYPE_SCROLL_INSENSITIVE: In questo caso possiamo andare 
avanti ed indietro nell'analisi del ResultSet, utilizzando alcuni meto- 
di che ci permettono appunto di non essere obbligati ad un analisi 
dei dati in una sola direzione 

• TYPE_SCROLL_SENSITIVE: Come il precedente ma inoltre c'è la 
possibilità che se dal momento in cui è stata effettuata la query i 
dati del database presenti nel ResultSet sono cambiati, allora que- 
sti cambiamenti si ripercuoteranno anche all'interno del ResultSet 

Con l'ultima tipologia abbiamo quindi anche la possibilità di avere i da- 
ti aggiornati all'interno del nostro ResultSet. Un'altra interessante pos- 
sibilità offerta dal ResultSet è quella che aggiornando i dati al suo inter- 
no venga aggiornato anche il database. Questa feature porta due ulte- 
riori tipologie di ResultSet: 

• CONCUR_READ_ONLY: Il ResultSet è di sola lettura 

• CONCUR_UPDATABLE: Il ResultSet può essere aggiornato e di 
conseguenza viene aggiornato il database. In questo caso però ab- 
biamo un livello di concorrenza più basso, permettendo l'accesso al 
database ad un numero minore di utenti per preservare la coeren- 
za dei dati 
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Queste caratteristiche che abbiamo visto, ed altre che non avremo mo- 
do di vedere, sono spesso dipendenti dall'implementazione JDBC che stia- 
mo utilizzando. Può succedere, ad esempio che il driver per un certo da- 
tabase non supporti la possibilità di aggiornare il ResultSet. Se il driver 
supporta queste feature (incluse in JDBC 2.0) allora possiamo creare i 
nostri ResultSet utilizzando i seguenti metodi 

//In questo caso verrà poi creato un ResultSet 

//di tipo TYPE_FORWARD_ONLY e CONCUR_READ_ONLY 

Statement statement = connection. createStatement(); 

//Ora invece avremo un ResultSet 

//di tipo TYPE_SCROLL_SENSITIVE e CONCURJJPDATABLE 

Statement statement = 

connection.createStatement(ResultSet.TYPE^SCROLL_SENSITIVE, 
ResultSet.CONCURJJPDATABLE); 

Per essere certi di poter utilizzare queste e magari altre feature presen- 
ti in JDBC è sempre il caso di controllare cosa viene detto dal fornitore 
del driver e soprattutto esaminare la feature che desideriamo attraver- 
so l'oggetto DatabaseMetaData che abbiamo già visto. In questo ca- 
so per sapere se il nostro driver supporta queste due feature, possiamo 
richiamare i metodi supportsResultSetTypeQ e supportsResultSetCon- 
currency(). Vediamo ora un esempio dove utilizziamo il ResultSet per 
aggiornare un campo attraverso la feature CONCUR_UPDATABLE: 

Statement statement = 

connection.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE,ResultSet. 

CONCI! R_UPDATABLE); 

ResultSet rs=statement.executeQuery("SELECT IDJELEFONO.EMAIL FROM 
UTENTI WHERE NOME='FEDERICO' AND COGNOME='PAPARONf "); 
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//ORA COMBINIAMO QUALCHE PASTICCIO INVERTENDO 
//I DUE VALORI E AGGIORNANDO LA RIGA SUL DB 
String email = rs.getString("EMAIL"); 
String telefono = rs.getString("TELEFONO"); 
rs.updateString(" EMAIL", telefono); 
rs.updateString("TELEFONO", email); 
rs.updateRow(); 

} 

Per effettuare l'aggiornamento di una riga abbiamo prima cambiato i va- 
ri campi e poi richiamato il metodo updateRowQ, il quale effettua il ve- 
ro e proprio UPDATE. Come potete vedere abbiamo creato lo Statement 
inserendo la tipologia di ResultSet CONCURJJPDA TABLE. Oltre a que- 
sto abbiamo dovuto inserire nella nostra SELECT la chiave primaria del- 
la tabella ed abbiamo selezionato una sola tabella. Questo perché, se 
avessimo fatto in maniera differente, saremmo andati contro le regole 
per il ResultSet aggiornabile definite dalle specifica JDBC e subito il dri- 
ver MySQL avrebbe seqnalato il problema 

com.mysql.jdbc.NotUpdatable: Result Set not updatable.This result set must 
come from a statement that was created with a result set type of 
ResultSet.CONCURJJPDATABLE, the query must select only one table, and 
must select ali primary keys from that table. See the JDBC 2.1 API 
Specification, section 5.6 for more details. 
at com.mysql.jdbc.UpdatableResultSet.generate 

Statements(UpdatableResultSet.java:558) 
at com.mysql.jdbc.UpdatableResultSet.sync 

Update(UpdatableResultSet.java:1344) 
at com .mysql .jdbc. U pdatableResu ItSet. 

updateString(UpdatableResultSet.java:2301) 
at com.mysql.jdbc.UpdatableResultSet. 

updateString(UpdatableResultSet.java:2339) 
at it.ioprogrammo.librodb.TestResultSet.main(TestResultSet.java:25) 
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LA SOTTOCLASSE 
PREPAREDSTATEMENT 

Ora che abbiamo visto come utilizzare Statement nelle nostre applica- 
zioni possiamo vedere PreparedStatement, che è una sua sottoclasse 
con alcune funzionalità aggiuntive. Statement permette di passare una 
vera e propria stringa SQL ai suoi metodi executeQueryed executeUp- 
date per inviare il comando di cui abbiamo bisogno. PreparedState- 
ment permette di definire un comando parametrizzandolo, ovvero inse- 
rendo delle variabili che verranno poi gestite dal programma a tempo di 
esecuzione. Praticamente guando dobbiamo fare una SELECT, con Sta- 
tement passiamo come argomento tutta la stringa SQL 

SELECT IDJELEFONO.EMAIL FROM UTENTI WHERE NOME='FEDERICO' 

AND COGNOME='PAPARONI' 



In questo caso, invece, possiamo parametrizzare il comando, in modo ta- 
le che possa essere utilizzato anche con altri valori 

SELECT IDJELEFONO.EMAIL FROM UTENTI WHERE NOME=? AND 

COGNOME=? 

PreparedStatement offre quindi dei metodi che permettono di settare 
i vari campi, come riportato nell'esempio seguente: 

PreparedStatement preparedStatement = connection. prepareStatement 

("SELECT IDJELEFONO.EMAIL FROM UTENTI WHERE NOME=? AND 

COGNOME=?"); 

preparedStatement.setString(1 , "FEDERICO"); 
preparedStatement.setString(2, "PAPARONI"); 
ResultSet rs=preparedStatement.executeQueryO; 
while(rs.next()) { 

String email = rs.getString(" EMAIL"); 
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System. out.println("Dati: "+email+" "+telefono); 

} 

rs.close(); 

connection. close(); 

I PreparedStatement aumentano l'efficienza del nostro codice nel ca- 
so in cui vengano utilizzati su query che vengono effettuate frequente- 
mente. Un esempio classico di utilizzo è quello relativo all'inserimento 
dei dati, dove parametrizziamo tutta la query e possiamo quindi "wrap- 
pare" il metodo di inserimento in un nostro metodo/classe che ci per- 
mette di gestire gli inserimenti passando i giusti parametri. 



GLI OGGETTI ROWSET 

Un ulteriore strumento che possiamo utilizzare di JDBC sono i RowSet. 
Questi oggetti, che estendono ResultSet, permettono una gestione mi- 
gliore dei dati recuperati da un database. Il RowSet implementa il mo- 
dello JavaBeans, quindi ha una gestione delle varie proprietà con i rela- 
tivi metodi get/set e un modello ad eventi che permette di agganciare 
a questo oggetto un listener, che viene notificato quando si verifica uno 
di questi 3 casi 

• Il cursore di lettura del RowSet viene spostato 

• C'è un inserimento, update o cancellazione riguardante una delle 
sue righe 

• Vengono cambiati tutti i dati relativi al RowSet 

Esistono diverse implementazioni di RowSet, che si differenziano pri- 
ma di tutto per quanto riguarda la connessione. Un RowSet, infatti, può 
essere connesso o meno, ovvero può fornire il risultato di un determina- 
to comando SQL stando connesso o meno al database. Oltre a questo 
c'è da dire che i RowSet possono essere associati anche a fonti dati dif- 
ferenti da un database, quindi il loro utilizzo potrebbe essere interes- 
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sante anche in altri ambiti. Vediamo ora quali sono i principali RowSet 
che vengono forniti da SUN: 

• JdbcRowSet: è l'unico RowSet che rimane connesso al database. 
Molto utile per la gestione dei dati attraverso il modello a eventi e 
soprattutto per la possibilità di avere un ResultSet aggiornabile e 
che permette lo scorrimento, visto che ogni implementazione di Row- 
Set lo deve permettere 

• CachedRowSet: è la prima implementazione dei RowSet disconnes- 
si, quelli che praticamente tengono tutti i dati in memoria e che si col- 
legano al database solo quando è strettamente necessario. Questa 
implementazione permette anche di serializzare l'oggetto per con- 
dividerlo in un ambiente distribuito 

• WebRowSet: estende CachedRowSet e permette, inoltre, di con- 
vertire tutto il contenuto del RowSet in un documento XML 

• JoinRowSet: estende WebRowSet ed aggiunge la possibilità di ef- 
fettuare il JOIN SQL tra due diversi RowSet senza avere la necessità 
di riconnettersi al database 

• FilteredRowSet: estende WebRowSet ed aggiunge la possibilità 
di raffinare il contenuto del RowSet in base a determinati filtri 

SUN ha distribuito oltre alle interfacce di questi RowSet anche una sua 
implementazione che possiamo utilizzare ed estendere a nostro piaci- 
mento. Vediamo ora l'utilizzo di uno dei RowSet più interessanti, We- 
bRowSet: 

package it.ioprogrammo.librodb; 

import com.sun.rowset.WebRowSetlrnpl; 
import java.io.FileWriter; 
import java.io.lOException; 
import java.sql.SQLException; 




28 



I libri di ioPROGRAMMo/Java e Database 



Capitolo I 



JDBC 



JAVA 

E DATABASE 



import java.util.logging.Logger; 
public class TestWebRowSet { 

public static void main(String a[]) { 
{ 

FileWriter writer = nuli; 
try { 

Class.forNameC'com.mysql.jdbc.Driver"); 
String uri = "jdbc:mysql://localhost:3306/libro"; 
WebRowSetlmpI webRowSet = new WebRowSetlmpl(); 
webRowSet.setCommand("SELECT NOME.COGNOME FROM 

UTENTI"); 

webRowSet.setUrl("jdbc:mysql://localhost:3306/libro"); 
webRowSet.setUsername("root"); 
webRowSet.setPassword( " mysql " ); 
webRowSet.executeO; 
writer = new FileWriter("test.xml"); 
webRowSet.writeXml(writer); 
webRowSet.closeO; 
} catch (lOException ex) { 
Logger.getLogger(TestWebRowSet.class.getNameO). 

log(Level.SEVERE, nuli, ex); 

} catch (SQLException ex) { 
Logger.getLogger(TestWebRowSet.class.getNameO). 

log(Level.SEVERE, nuli, ex); 

} catch (ClassNotFoundException ex) { 
Logger.getLogger(TestWebRowSet.class.getNameO). 

log(Level.SEVERE, nuli, ex); 

} 

finally { 
try { 

writer.close(); 
} catch (lOException ex) { 
Logger.getLogger(TestWebRowSet.class.getNameO). 
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log(Level.SEVERE, nuli, ex); 



} 

} 

In questo caso non abbiamo avuto bisogno di creare una connessione 
come nei casi precedenti, ma è direttamente il WebRowSet che la ge- 
stisce. Sono stato settati tutti i parametri necessari attraverso dei meto- 
di set ed infine abbiamo trasformato il contenuto del WebRowSet in 
un file xml, salvandolo su filesystem: 

<?xml version="1.0"?> 

<webRowSet xmlns=" http://java.sun.com/xml/ns/jdbc" 

xmlns:xsi=" http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation=" http://java.sun.com/xml/ns/jdbc 

http://java.sun.com/xml/ns/jdbc/webrowset.xsd"> 

<properties> 

<command>SELECT NOME.COGNOME FROM UTENTk/command> 



<datasourcexnull/x/datasource> 

<escape-processing>true</escape-processing> 

<fetch-direction>1000</fetch-direction> 

<fetch-size>0</fetch-size> 

<isolation-level>2</isolation-level> 

<key-columns> 

</key-columns> 

<map> 

</map> 

<max-field-size>0</max-field-size> 
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<query-timeout>0</query-timeout> 
<read-only>true</read-only> 

<rowset-type>ResultSet.TYPE_5CR0LL_INSENSITIVE</rowset-type> 

<show-deleted>false</show-deleted> 

<tab]e-name>UTENTI</table-name> 

<url>jdbc:mysql://localhost:3306/libro</url> 

<sync-provider> 

<sync-provider-name>com.sun.rowset.providers.RIOptimisticProvider 

</sync-provider-name> 

<sync-provider-vendor>Sun Microsystems lnc.</sync-provider-vendor> 

<sync-provider-version>1.0</sync-provider-version> 

<sync-provider-grade>2</sync-provider-grade> 

<data-source-lock>1</data-source-lock> 
</sync-provider> 
</properties> 
<metadata> 
<column-count>2</column-count> 
<column-definition> 

<column-index>1 </column-index> 

<auto-increment>false</auto-increment> 

<case-sensitive>false</case-sensitive> 

<currency>false</currency> 

<nullable>0</nullable> 

<signed>false</signed> 

<searchable>true</searchable> 

<column-display-size>45</column-display-size> 

<column-label>NOME</column-label> 

<column-name>NOME</column-name> 

<schema-namex/schema-name> 

<column-precision>45</column-precision> 

<column-scale>0</column-scale> 

<table-name>UTENTk/table-name> 

<cata]og-name>libro</catalog-name> 
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<column-type>1 2</column-type> 
<column-type-name>VARCHAR</column-type-name> 
</column-definition> 



<column-index>2</column-index> 

<auto-increment>false</auto-increment> 

<case-sensitive>false</case-sensitive> 

<currency>false</currency> 

<nullable>0</nullable> 

<signed>false</signed> 

<searchable>true</searchable> 

<column-display-size>45</column-display-size> 

<column-label>COGNOME</column-label> 

<column-name>C0GNOME</column-name> 

<schema-namex/schema-name> 

<column-precision>45</column-precision> 

<column-scale>0</column-scale> 

<table-name>UTENTk/table-name> 

<catalog-name>libro</catalog-name> 

<column-type>1 2</column-type> 

<column-type-name>VARCHAR</column-type-name> 



</metadata> 
<data> 
<currentRow> 
<columnValue>Federico</columnValue> 
<columnValue>Paparoni</columnValue> 
</currentRow> 
<currentRow> 
<columnValue>John</columnValue> 
<columnValue>Doe</columnValue> 



</currentRow> 
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</webRowSet> 



Questo file XML è la rappresentazione del WebRowSet, dove vengono 
riportate tutte le informazioni in esso contenute. Il file XML può, in un 
classico scenario di utilizzo, essere archiviato su filesystem, magari per 
essere elaborato da altri processi, che dovranno semplicemente impor- 
tarlo nel seguente modo: 

WebRowSetlmpI webRowSet = new WebRowSetlmpl(); 
java.io. FileReader reader = new java. io.FileReader("test.xml"); 
webRowSet.readXml(reader); 



EFFETTUARE TRANSAZIONI 

È possibile realizzare transazioni in diversi modi. Uno dei modi che ab- 
biamo già visto è quello di gestire la transazione attraverso i metodi se- 
tAutoCommìtO, commitQ e rollback!). Qui di seguito vediamo un esem- 
pio che utilizza questi metodi: 

Class.forlMameC'com.mysql.jdbc.Driver"); 

String uri = "jdbc:mysql://localhost:3306/libro"; 

Connection connection = DriverManager.getConnection(url, "root", 

"mysql"); 

connection.setAutoCommit(false); 



//DOPO UNA SERIE DI OPERAZIONI EFFETTUIAMO UN SAVEPOINT 
//AL QUALE POSSIAMO TORNARE SUCCESSIVAMENTE SE QUALCOSA NON 

VA PER IL VERSO GIUSTO 

SavePoint savePoint=connection.setSavepoint(); 
try{ 
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connection. commit(); 
} 

catch(SQLException e) { 

connection.rollback(savePoint); 

} 

connection. setAutoCommit(true); 

Come potete vedere, in questo caso, per gestire le nostre operazioni in 
maniera transazionale, abbiamo disabilitato l'auto commit. Poi abbia- 
mo salvato ad un certo punto le operazioni fatte attraverso un Save- 
Point. Questo oggetto ci permette di memorizzare un certo numero di 
operazioni che sono state fatte sulla nostra connessione. In questo mo- 
do, se in seguito avviene qualcosa di errato, nel nostro codice, possia- 
mo effettuare il rollback, tornando direttamente al punto che abbiamo 
salvato attraverso il metodo rollback di Connection che accetta come 
parametro un SavePoint. Nel caso in cui tutto proceda correttamente pos- 
siamo invece effettuare la commit. Alla fine di tutte le operazioni che 
abbiamo effettuato in questa "transazione" possiamo ripristinare l'auto 
commit. Diciamo che i SavePoint possono essere utilizzati come dei 
punti di backup della nostra transazione, che noi possiamo richiamare 
in base a quello che succede nel nostro programma. Oltre a questo me- 
todo, Java mette a disposizione una API che ci permette di definire ad 
alto livello una transazione, Java Transaction API (JTA). Attraverso que- 
sta API possiamo gestire diverse risorse all'interno di una transazione. 
Una di queste risorse può essere tranquillamente un database oppure 
una coda JMS o una qualsiasi risorsa che permette di essere gestita at- 
traverso JTA (di solito queste informazioni vengono riportate nella do- 
cumentazione di un determinato prodotto). Per quanto riguarda un da- 
tabase dobbiamo prima di tutto avere a disposizione dei driver che per- 
mettono di ottenere un XADataSource, un'interfaccia che riesce a ge- 
stire la connessione al database come una risorsa all'interno di una 
transazione. Il classico esempio in cui possiamo utilizzare JTA è quello 
in cui, all'interno di un Application Server, la nostra applicazione deve ge- 
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stire diversi database in maniera transazionale. Possiamo immaginare di 
dover spostare delle informazioni da un database all'altro, magari dei sol- 
di da un conto ad un altro. Chiaramente questa operazione deve esse- 
re eseguita all'interno di una transazione, perché se qualcosa va male 
non possiamo prelevare soldi da un conto senza inserirli da qualche al- 
tra parte. Vediamo, quindi, come possiamo realizzare questa funziona- 
lità attraverso le JTA: 

//INIZIAMO CON IL REPERIRE LE CONNESSIONI VERSO 

112 DIVERSI DATASOURCE, CONFIGURATI LATO SERVER PER ESSERE 

UTILIZZATI IN TRANSAZIONI 

InitialContext ctx=new InitialContextO; 
DataSource 

banca1=(javax.sql.DataSource)ctx.lookup("java:comp/env/jdbc/Banca1 "); 



DataSource 

banca2=(javax.sql.DataSource)ctx.lookup("java:comp/env/jdbc/Banca2"); 
Connection connessionel =banca1 .getConnection(); 
Connection connessione2=banca2.getConnection(); 



//ORA DOBBIAMO OTTENERE TRAMITE JNDI LO USERTRANSACTION 
//L'OGGETTO CHE CI PERMETTE DI INCAPSULARE LE OPERAZIONI CHE 

FARANNO PARTE DELLA NOSTRA TRANSAZIONE 



UserTransaction 

userTransation=(UserTransaction)ctx.lookup(URL_USER_TRANSACTION); 
UserTransaction. begin(); 
prendiSoldi(connessione1 ); 
depositaSoldi(connessione2); 
userTransaction.commit(); 
connessionel .close(); 
connessione2.close(); 
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In questo esempio abbiamo immaginato di avere configurato sul no- 
stro Application Server due diversi DataSource, che per la precisione so- 
no XADataSource, ovvero che possono entrare a far parte di una tran- 
sazione. Questa configurazione cambia per ogni Application Server, 
quindi per maggiori dettagli vi rimando alla guida di ognuno. Dopo che 
abbiamo ottenuto le due diverse connessioni, abbiamo recuperato tra- 
mite JNDI lo UserTransaction, che è l'oggetto utilizzabile dal punto di 
vista del client, il quale ci permette di inglobare diverse operazioni all'in- 
terno di una transazione. La vera e propria transazione è trasparente 
per il programmatore, non c'è cioè bisogno di realizzare tutta la comu- 
nicazione con le diverse entità in gioco. Di questo se ne occupa il Tran- 
sactionManager, che è integrato nel nostro Application Server e che im- 
plementa il famoso Two Phase Commit (2PC) per garantire la transazio- 
ne. Questo protocollo prevede che per ogni risorsa in gioco ci siano ap- 
punto due diverse fasi: 

1 . Nella prima fase viene inviato ad ogni risorsa la query da eseguire. 
Per andare avanti ogni risorsa deve rispondere con un OK 

2. Nella seconda fase, il coordinatore chiede di effettuare la commit 
della query. Per dichiarare la transazione completata ogni risorsa 
deve inviare un OK al coordinatore 

Come potete vedere dal precedente codice, non siamo dovuti interve- 
nire sulla singola connessione per effettuare il commit, proprio perché 
la transazione viene gestita dalTransactionManager che è presente nel 
nostro ApplicationServer. In questo caso abbiamo inserito nella nostra 
transazione soltanto delle connessioni verso il database, ma potevamo 
inserire anche una coda JMS o un sistema ERP. 

CONSIDERAZIONI 

JDBC è un ottimo prodotto, che permette al programmatore Java di dia- 
logare subito con un database. Anche lefeature che offre dal punto di 
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vista delle API sono molte ed interessanti. In maniera dipendente dal 
progetto di cui ci stiamo occupando può essere utile o meno sviluppa- 
re la nostra applicazione utilizzando JDBC. Infatti, attualmente, esisto- 
no molti prodotti opensource (alcuni dei quali vedremo nei prossimi ca- 
pitoli) che si basano su JDBC per offrire allo sviluppatore un'interfaccia 
ad alto livello e che sono una valida alternativa anche perché nella mag- 
gior parte dei casi velocizzano lo sviluppo. 
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Hibernate è una famosa libreria/framework Java, realizzata da Gavin 
King, che permette di avere un ORM (Object Relational Mapping) per il 
nostro software. Non stiamo parlando di un vero e proprio database 
ad oggetti ma di un tool che ci permette di avvicinare il paradigma ad 
oggetti di Java con quello relazionale dei database. 



Programmazione Object 
Ortented 




Figura 2.1: Object Relational Mapping 



Un ORM come Hibernate cerca quindi di rendere trasparente allo svilup- 
patore la presenza di un database relazionale, cercando di effettuare 
un mapping Classe-Tabella. Hibernate è attualmente arrivato alla ver- 
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sione 3.2.5 ed è un progetto opensource molto vasto, che comprende 
al suo interno diversi "sottoprogetti" molto interessanti: 

• Hibernate Core: Il cuore del progetto Hibernate 

• Hibernate Annotations: Annotations che possono essere usate 
con Hibernate per evitare i file di mapping XML 

• Hibernate Entity Manager: Implementazione delle Java Persi- 
stence API che si appoggia ad Hibernate Core. Questo progetto vie- 
ne attualmente utilizzato di default in JBoss EJB 3.0 

• Hibernate Shards: È un framework che ci permette di utilizzare 
Hibernate Core anche in quei casi in cui il nostro database viene 
partizionato, stravolto. 

• Hibernate Validator: Serve per effettuare la validazione dei bean 
che stiamo per inserire/editare, utilizzando delle semplici annota- 
tions 

• Hibernate Search: Framework che fornisce un'interessante API 
per effettuare ricerche nel nostro database, sfruttando le potenzia- 
lità di Apache Lucene (http://lucene.apache.org) 

• Hibernate Tools: Plugin Ant/Eclipse per sviluppare le nostre ap- 
plicazioni con Hibernate 

• NHibernate: Porting .NET di Hibernate 

• JBoss Seam: Framework web che utilizza Hibernate come "collan- 
te" tra JSF e EJB 3.0 

Hibernate è compatibile con tutti i database che supportano JDBC, per- 
mettendo quindi di slegare il più possibile lo sviluppo della nostra appli- 
cazione dalla parte relativa al database. Questo già succedeva con JDBC, 
ma con un tool di ORM possiamo gestire la parte relativa ai dati della no- 
stra applicazione in maniera ancora meno vincolante. Per effettuare del- 
le ricerche Hibernate fornisce un potente linguaggio che è l'HQL [Hiber- 
nate QueryLanguage), oltre a supportare l'SQL standard e le interessan- 
ti query realizzate con i Criterìa che avremo modo di vedere successiva- 
mente. 
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PRIMI PASSI 

Come avrete intuito, anche guardando la tantissima documentazione presente 
sull'homepage del progetto {http://www.hibernate.org), Hibernate è 
un progetto molto interessante e con molte cose da imparare. 
Come per ogni libreria Java, anche in questo caso sarà necessario sca- 
ricare il JAR di questa libreria e includerlo nel nostro progetto. 
Per iniziare ad utilizzare questo tool vedremo ora un esempio comple- 
to, andando poi in dettaglio su tutte le peculiarità di questo progetto nei 
successivi paragrafi. Il nostro punto di partenza sarà una semplice clas- 
se Libri: 

package it.ioprogrammo.librodb.hibernate; 

public class Libri implements java.io.Serializable { 

private Integer id; 
private String isbn; 
private String titolo; 
private String autore; 
private String categoria; 

public Libri() { 

} 

public Libri(String isbn, String titolo, String autore, String categoria) { 
this.isbn = isbn; 
this.titolo = titolo; 
this.autore = autore; 
this.categoria = categoria; 

} 

public Libri(String isbn, String titolo, String autore, String categoria, 
Set redazionis) { 
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this.isbn = isbn; 
this.titolo = titolo; 
this.autore = autore; 



this.redazionis = redazionis; 

} 



public Integer getld() { 
return this.id; 

} 

public void setld(lnteger id) { 
this.id = id; 

} 

public String getlsbn() { 
return this.isbn; 

} 

public void setlsbn(String isbn) { 
this.isbn = isbn; 




public String getTitolo() { 
return this.titolo; 

} 

public void setTitolo(String titolo) { 
this.titolo = titolo; 

} 



public String getAutore() { 
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} 

public void setAutore(String autore) { 
this.autore = autore; 

} 

public String getCategoria() { 
return this.categoria; 

} 

public void setCategoria(String categoria) { 
this.categoria = categoria; 

} 

} 

La classe Libri è il solito JavaBean che possiamo utilizzare nella logica 
di business della nostra applicazione. Definiamo sul nostro database la 
tabella sulla quale verranno mappati gli oggetti di questa classe: 

CREATE TABLE 'libro' ."libri" ( 
'ID' INTEGER UNSIGNED NOT NULLAUTOJNCREMENT, 
'ISBN' VARCHAR(45) NOT NULL, 
'TITOLO' VARCHAR(45) NOT NULL, 
'AUTORE' VARCHAR(45) NOT NULL, 
'CATEGORIA' VARCHAR(45) NOT NULL, 
PRIMARY KEY ('ID') 

) 

A questo punto, con le classiche connessioni JDBC avremmo creato una 
Connection verso il database e gestito l'inserimento/lettura/modifica/ can- 
cellazione di questi dati attraverso Statement, ResultSet e tecnologie 
analoghe. Utilizzando Hibernate dobbiamo prima di tutto far capire a 
questo tool quale è il database con cui deve dialogare. Questo è possi- 




I libri di ioPROGRAMMO/Java e Database 



43 



JAVA 
E DATABASE 



HIBERNATE 



Capitolo 2 



bile attraverso il file di configurazione di Hibernate, che vediamo ripor- 
tato qui di seguito 

<?xmlversion="1.0"encoding="utf-8"?> 
<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
" http://hibernate.sourceforge.net/hibernate-configuration-3. 0.dtd"> 
<hibernate-configuration> 
<session-factory> 
<property 

name="hibernate.bytecode.use_reflection_optimizer">false</property> 
<property 

name="hibernate.connection.driver_class ">com.mysql.jdbc.Driver</prop 

erty> 

<property 

name= " hibernate.connection. password " >mysqk/property> 
<property 

name="hibemate.connection.url">jdbc:mysql://1 27.0.0.1 /libro</property 

> 

<property name= " hibernate.connection. username " >root</property> 
<property 

narne="hibernat,dialecf>org.hibernate.dialect.MySQLDialect</property 

> 

<property 

name= " hibernate.current_session_context_class " >thread</property> 
<mapping 

resource="it/ioprogrammo/librodb/hibernate/Libri.hbm.xml" /> 
</session-factory> 
</hibernate-configuration> 

Questo file XML, denominato per default hibernate.cfg.xml, descri- 
ve al tool alcune cose che gli servono per accedere al database co- 
me uri JDBC, driver JDBC, username e password. Viene inoltre spe- 
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cificato quale "dialetto" SQL utilizzare con la property hiberna- 
te.dialect. Esistono infatti molti "dialetti" SQL che cambiano sensi- 
bilmente la gestione di diverse cose all'interno del database. 
Alla fine di questa configurazione abbiamo anche detto a Hiberna- 
te che esiste la definizione di una risorsa da mappare su questo da- 
tabase, utilizzando la seguente stringa 

<mapping resource="it/ioprogrammo/librodb/hibernate/Libri.hbm.xml" /> 

Il file XML a cui ci siamo riferiti, Libri. hbm. xml, definisce il mapping 
su database per la nostra classe Libri. Attraverso questo file riuscia- 
mo quindi a spiegare ad Hibernate come deve far corrispondere le 
proprietà di un oggetto Libri alle colonne della tabella libri. Qui di se- 
guito potete vedere la sua struttura: 

<?xml version="1 .0"?> 

<!DOCTYPE hibemate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 

DTD3.0//EN" 

" http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd " > 

<!-- Generated 29-gen-2008 15.21.25 by Hibernate Tools 3.2.0.CR1 --> 

<hibernate-mapping> 

<class name="it.ioprogrammo.librodb.hibernate.Libri" table= " libri " 

catalog="libro"> 

<id name="id" type="java.lang.lnteger"> 

<column name="ID" /> 

<generator class="identity" /> 
</id> 

<property name="isbn" type="string"> 

<column name="ISBN" length="45" not-null="true" /> 
</property> 

<property name="titolo" type="string"> 

<column name="TITOLO" length="45" not-null="true" /> 
</property> 
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<property name="autore" type="string"> 

<column name= "AUTORE" length="45" not-null="true" /> 
</property> 



<column name="CATEGORIA" length="45" not-null="true" /> 

</property> 
</class> 
</hibernate-mapping> 

In Libri. hbm.xml possiamo vedere come viene riportato, proprietà per 
proprietà, il mapping da compiere. All'inizio del file c'è l'associazione tra 
nome della classe (comprensivo di package) e nome della tabella 

<class name="it.ioprogrammo.librodb.hibernate.Libri" table= " libri " cata 



Per l'id della tabella libri viene associato un generatore di ID, che in 
questo caso è identità, che gestirà l'id della tabella libri. Successiva- 
mente vengono riportate tutte le proprietà con nome, tipologia e 
colonna da associare. A questo punto Hibernate sa come collegarsi 
al nostro database, come dialogarci e soprattutto come gestire il 
mapping tra la nostra classe ed una tabella. Per concludere questo 
paragrafo introduttivo vedremo, quindi, un semplice esempio dove 
andiamo a creare un oggetto della classe Libri e salvarlo sul databa- 
se: 

package it.ioprogrammo.librodb.hibernate; 
import org.hibernate.Session; 
import org.hibernate.SessionFactory; 



import org.hibernate.cfg.Configuration; 
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public class PrimiPassi { 

public static void main(5tring[] args) { 
SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.getCurrentSessionO; 

session.beginTransactionO; 
Libri libro=new Libri(); 
libro.setAutore(" Federico Paparoni"); 
libro.setCategoria(" IT/Database"); 
libro.setlsbn("123457890"); 
libro.setTitolo("Java e database"); 
session. save(libro); 
session. getTransaction().commit(); 



} 



s 



Nelle prime righe di questa classe abbiamo recuperato un oggetto 
Session, che permette di gestire una sessione con il nostro databa- 
se. Di solito questo oggetto viene gestito a livello di Application Ser- 
ver o con altri Session Factory che ci permettono una gestione miglio- 
re quando stiamo sviluppando un progetto. Comunque, attraverso Session, 
riusciamo a far partire la transazione all'interno della quale inserire- 
mo il nostro oggetto. Per fare ciò dobbiamo semplicemente costrui- 
re una nuova istanza di Libri, settare i vari parametri e poi richiama- 
re il metodo saveQ di Session. Per concludere il nostro esempio dob- 
biamo chiamare la commitQ e possiamo vedere che sul nostro data- 
base sarà presente una nuova riga nella tabella libri. 
Hibernate definisce 3 diversi stati che il nostro oggetto può avere: 

• Transient: L'oggetto che vogliamo utilizzare è stato inizializzato 
ma non è ancora collegato in alcun modo con una sessione Hiber- 
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Figura 2.2: Nuova entry nel nostro database 



nate, quindi non esiste un suo mapping sul database e i possibili 
cambiamenti che facciamo su questo oggetto non si ripercuotono sul 
database 

• Persistenti L'oggetto è stato associato ad una sessione Hiberna- 
te, salvandolo su database attraverso il metodo saveQ oppure ef- 
fettuando una query. In questo stato l'oggetto ha una corrispon- 
denza nel nostro database 

• Detached: L'oggetto, che abbiamo precedentemente ricavato da 
una sessione Hibernate, ora è slegato da essa quindi qualsiasi cosa 
succede a questo oggetto non avrà alcuna conseguenza sul databa- 
se, a meno che l'oggetto non venga ricollegato ad una nuova ses- 
sione 

Gli oggetti che si trovano nello stato Transient possono passare allo 
stato Persisterli utilizzando i seguenti metodi della classe 
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org.hibernate.Session: saveQ, persisti) e saveOrUpdateQ. In questo 
modo viene effettuato il mapping su database. Se invece abbiamo un og- 
getto che è stato recuperato dal database, questo è già nello stato Per- 
sistei, mentre se chiudiamo la sessione che lo ha recuperato allora 
entriamo nello stato Detached. Nei prossimi paragrafi vedremo i diver- 
si modi che Hibernate offre per effettuare la ricerca sul nostro databa- 
se. In seguito approfondiremo le questioni relative a mapping più com- 
plessi di quello che abbiamo ora realizzato. 



HQL E SQL 

Uno dei metodi che Hibernate offre per effettuare delle ricerche è quel- 
lo di utilizzare l'HQL, Hibernate QueryLanguage. Questo linguaggio per- 
mette di definire in maniera simile alI'SQL, ma Object Oriented, una 
query da effettuare. Vediamo un esempio dove utilizziamo questo linguag- 
gio per recuperare tutte le istanze di Libri dal database: 

package it.ioprogrammo.librodb.hibernate; 

import java.util.lterator; 

import org.hibernate.Query; 
import org.hibernate.Session; 
import org.hibernate.SessionFactory; 
import org.hibernate.cfg.Configuration; 

public class QueryHQL { 

public static void main(String[] args) { 
SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.openSession(); 
String queryHQL="from Libri"; 
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Query query=session.createQuery(queryHQL); 
Iterator iterator=query.iterate(); 
Libri temp; 



temp=(Libri)iterator.next(); 
System. out.println("Titolo: "+temp.getTitolo()); 
System. out.printlnf Autore: "+temp.getAutore()); 
System. out.println(" ISBN: "+temp.getlsbn()); 

} 

session.close(); 

} 

} 

La query HQL che ci serve per effettuare quello che in SQL sarebbe un 
"SELECT * FROM LIBRI" è "from Libri" . In questo caso però, Libri non 
è la tabella ma la classe a cui siamo interessati. Praticamente con l'HQL 
noi abbiamo un linguaggio per effettuare le query sul nostro database, 
ma possiamo continuare a ragionare nell'ottica 00 della nostra appli- 
cazione. Questo linguaggio conserva tutte le caratteristiche standard 
delI'SQL, come ad esempio le clausole "WHERE" e "ORDER BY".M esem- 
pio se fossimo interessati a recuperare tutti i libri che hanno come ca- 
tegoria "IT/Software Engineering" e ordinarli in base al titolo, la nostra 
query HQL sarebbe la seguente: 

from Libri libri where libri.categoria='IT/Software Engineering' order by 

libri.titolo 

L'esecuzione di queste query viene demandata a Hibernate attraverso il 
metodo createQueryQ di Session, che prende come argomento una 
stringa contenente la query. Come risultato abbiamo un oggetto Query, 
che possiamo utilizzare attraverso un classico Iterator. E' possibile anche 
gestire il join di diversi oggetti tramite HQL, collegamenti che possono 
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essere definiti sempre tramite Hibernate e che vedremo in un paragrafo 
successivo. Hibernate, nonostante sia un framework per l'Object Rela- 
tional Mapping e gestisca nativamente tutte le sessioni di dialogo con 
il nostro database, ci permette di utilizzare l'SQL. A primo impatto si 
potrebbe pensare che questo sia un controsenso, ma talvolta invece 
può essere necessario utilizzare l'SQL nativo del nostro database, per uti- 
lizzare magari funzioni specifiche che non potremmo utilizzare in altre 
maniere. Per utilizzare l'SQL standard dobbiamo utilizzare il metodo 
createSQLQuery() di Session, passando come argomento la classica 
querySQL: 



package it.ioprogrammo.librodb.hibernate; 

import java.util.lterator; 
import java. util. List; 



import org.hibemate.Hibemate; 
import org.hibemate.SQLQuery; 
import org.hibernate.Session; 
import org.hibemate.SessionFactory; 
import org.hibemate.cfg.Configuration; 



public class QuerySQLNativo { 



public static void main(5tring[] args) { 
SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.openSession(); 
String querySQL="SELECT * FROM LIBRI"; 
SQLQuery query=session.createSQLQuery(querySQL); 
query=query.addScalar("TITOLO",Hibernate.STRING); 
query=query.addScalar("AUTORE",Hibernate.STRING); 

query=query.addScalar("ISBN",Hibernate.STRING); 
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List list=query.list(); 

Iterator iterator=list.iterator(); 

Object[] temp; 



temp=(Object[])iterator.next(); 
for(int i=0;i<temp.length;i++) { 
System. out.println(temp[i]); 

} 

} 

session.close(); 

} 

} 

Con la query SQL che abbiamo definito, siamo in grado di recuperare tut- 
ti valori della tabella libri. Utilizzando il metodo addScalarQ di Query ab- 
biamo definito quali campi sono di nostro interesse. Quello che ci vie- 
ne restituito alla fine è una lista che al suo interno ha array di Object. 
Ogni array rappresenta una riga con le varie colonne che abbiamo se- 
lezionato. Chiaramente quando utilizziamo altre tipologie di ricerca con 
Hibernate siamo facilitati dalla gestione Object Oriented dei dati. Dicia- 
mo che questa tipologia di ricerca è stata inclusa nel progetto per quei 
casi particolari in cui è necessario utilizzare l'SQL nativo del database. 

LE API CRITERIA 

I Criteria sono una delle API più interessanti che Hibernate mette a di- 
sposizione, perché permette di definire una query, modellandola da un 
punto di vista Object Oriented. 

Proprio per questo esiste un package dedicato, org.hibernate.crìterion, 
che include al suo interno tutta una serie di interfacce e classi che ser- 
vono per modellare le nostre query. 

Vediamo, quindi, un esempio in cui utilizziamo i Criteria di Hibernate: 
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package it.ioprogrammo.librodb.hibernate; 



import java.util.lterator; 
import java. util. List; 



import org.hibemate.Criteria; 
import org.hibernate.Session; 
import org.hibemate.SessionFactory; 
import org.hibernate.cfg.Configuration; 
import org.hibernate.criterion.Order; 

public class QueryCriteria { 

public static void main(5tring[] args) { 
Criteria criteria; 
Libri temp; 

SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.openSession(); 

criteria = session. createCriteria(Libri. class); 
criteria.setMaxResults(20); 
criteria.addOrder(Order.asc(" titolo")); 
List lista = criteria. Iist(); 



s 



Iterator iterator=lista.iterator(); 
while(iterator.hasNext()) { 

temp=(Libri)iterator.next(); 

System. out.println(temp.getTitolo()+ " - 

" +temp.getCategoria()); 

} 

session. close(); 
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} 

Per effettuare una semplice ricerca con i Criteria abbiamo utilizzato il me- 
todo createCriteriaQ di Session, passando come parametro la classe a 
cui siamo interessati. In questo modo è come se avessimo fatto una 
"SELECT * FROM LIBRI", perché non abbiamo specificato alcun vinco- 
lo. L'unica cosa particolare che abbiamo fatto è decidere il numero di ri- 
sultati da recuperare utilizzando il metodo setMaxResultsQ. Inoltre ab- 
biamo deciso che vogliamo i risultati della nostra query, ordinati in ba- 
se alla proprietà "titolo" grazie al metodo addOrderQ di Criteria. 
Già da questo primo esempio potete vedere come sia elegante e sem- 
plice il metodo di ricerca basato sui Criteria. Chiaramente, le possibilità 
offerte da questa API vanno oltre la semplice select. Molto spesso suc- 
cede di dover modellare nel nostro codice una query in base a determi- 
nati parametri che vengono richiesti. Per avvicinarci al nostro esempio, 
potremmo aver bisogno di elencare tutti i libri che fanno parte di una cer- 
ta categoria e che contengono al loro interno una stringa. Per fare ciò 
non dobbiamo far altro che aggiungere al Criteria che stiamo utilizzan- 
do alcune restrizioni, come potete vedere nel seguente codice: 

Criterioncrit1=Restriction,eq("categoria". "IT/Database"); 
Criterion crit2=Restrictions.eq("categoria", "IT/Software Development"); 
Criterion crit3=Restrictions.or(crit1, crit2); 
criteria. add(crit3); 



Attraverso i metodi statici della classe org.hibernate.criterion.Restrictions 
abbiamo definito 3 diversi Criterion, ovvero 3 diverse restrizioni da ap- 
plicare alla nostra ricerca tramite Criteria. Nel primo abbiamo richiesto 
che il parametro categoria fosse uguale a "IT/Database", nel secondo 
a "IT/Software Development" .Con il terzo Criterion abbiamo invece 
accorpato i due precedenti utilizzando un OR logico. In questo modo la 
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nostra ricerca ritornerà risultati che soddisfano la prima o la seconda 
condizione. Questo è solo una delle tante cose che ci permette di mo- 
dellare la query attraverso i Criteria. Immaginiamo, ad esempio, di vo- 
ler realizzare una serie di ricerche che devono essere fatte per ottenere 
i libri che iniziano con una particolare lettera. Questo è possibile con il 
modello likeQ di Restrictions, al quale passiamo come parametri qua- 
le variabile, cosa ricercare e in quale modalità: 

Criterion letterA=Restrictions.like("titolo","A",MatchMode.5TART); 
Criterion letterB=Restrictions.like("titolo","B",MatchMode.START); 
Criterion letterC=Restrictions.like("titolo","C",MatchMode.START); 



Vedendo in dettaglio tutti i vari metodi di Restrictions si intuisce che, 
utilizzando i Criteria, possiamo creare un semplice ma potente sistema 
per effettuare query sul nostro database. 



s 



QUERY BY EXAMPLE 

Passiamo ora ad un ulteriore metodo che ci permette di effettuare del- 
le query utilizzando Hibernate. Con i Criteria possiamo definire in ma- 
niera programmatica, e non attraverso delle stringhe, una ricerca da ef- 
fettuare. Basandoci su questa API possiamo anche effettuare una ricer- 
ca passando come parametro un vero e proprio oggetto, della stessa 
tipologia che ci aspettiamo come risultato, valorizzando le proprietà che 
verranno poi utilizzate per effettuare la ricerca. Praticamente, se voglia- 
mo cercare un libro con un determinato titolo, possiamo anche creare 
un nuovo oggetto, settare solo il titolo e poi avviare la ricerca. 
Hibernate lo analizzerà e ricercherà soltanto i mapping che possono 
corrispondere ad un oggetto con quel titolo: 
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package it.ioprogrammo.librodb.hibernate; 
import java.util.lterator; 
import java. util. List; 



I libri di ioPROGRAMMO/Java e Database 



55 



JAVA 
E DATABASE 



HIBERNATE 



Capitolo 2 



import org.hibernate.Criteria; 
import org.hibernate.Session; 
import org.hibernate.SessionFactory; 
import org.hibernate.cfg.Configuration; 
import org.hibernate.criterion.Example; 

public class QueryByExample { 

public static void main(String[] args) { 
Criteria criteria; 
Libri temp; 

SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.open5ession(); 
Libri libro=new Libri(); 
libro.setTitolo("Java e database"); 

Example libroExample; 

libroExample=Example.create(libro); 

libroExample.ignoreCaseQ; 



criteria. add(libroExample); 
List I ista=criteria . I ist(); 
Iterator iterator=lista.iterator(); 
while(iterator.hasNext()) { 

temp=(Libri)iterator.next(); 

System. out.println(temp.getTitolo()+" - 

"+temp.getCategoria()); 

} 

session. close(); 



} 
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} 

Tale metodologia viene definita "querybyexample" , poiché andiamo 
a realizzare un oggetto Example, passandolo come parametro d'esempio 
da ricercare. In seguito viene creato un Criteria che si basa sulla classe 
Libri e andiamo ad aggiungere questo oggetto d'esempio. In questo 
modo abbiamo realizzato la nostra ricerca utilizzando un oggetto come 
modello. 



ASSOCIAZIONI 

Incominciamo ora a considerare un nuovo database, dove abbiamo di- 
verse entità che entrano in gioco. Fino al precedente paragrafo abbia- 
mo visto solo come mappare una singola classe con una tabella. Ora ve- 
diamo come viene modificato il nostro database, introducendo nuove ta- 
belle con delle foreign key. Per il momento avevamo solo la tabella libri, 
ad un certo punto decidiamo di cambiare il nostro database, gestendo 
anche l'informazione relativa all'autore. Definiamo quindi due diverse tabelle, 
autore e libri, che gestiranno meglio questa informazione. Praticamen- 
te l'informazione che era presente prima nella tabella libri, sotto la co- 
lonna AUTORE, adesso diventa importante per il dominio della nostra 
applicazione e quindi dobbiamo gestirla in maniera differente. 
Ecco quindi lo script SQL per generare il database che dobbiamo utiliz- 
zare: 



CREATE TABLE 'libro'.'autore' ( 
'ID' INTEGER UNSIGNED NOT NULLAUTOJNCREMENT, 
'NOME' VARCHAR(45) NOT NULL, 
'COGNOME' VARCHAR(45) NOT NULL, 
'EMAIL' VARCHAR(45) NOT NULL, 
PRIMARY KEY ('ID') 

) 

ENGINE = lnnoDB; 
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CREATE TABLE 'libro' .'libri' ( 
'ID' INTEGER UNSIGNED NOT NULLAUTOJNCREMENT, 
'ISBN' VARCHAR(45) NOT NULL, 



'CATEGORIA VARCHAR(45) NOT NULL, 
'ID_AUTORE' INTEGER UNSIGNED NOT NULL, 
PRIMARY KEY ('ID'), 

CONSTRAINT 'FK_libri_1' FOREIGN KEY 'FKJibriJ' ('ID_AUTORE') 
REFERENCES 'autore' f ID') 
ON DELETE CASCADE 
ON UPDATE CASCADE 

) 

ENGINE = InnoDB; 

La seconda cosa che dobbiamo poi cambiare, è il file di mapping della 
classe Libri. Ora non avremo più una semplice proprietà relativa ad una 
colonna, ma una relazione di tipo molti ad uno, ovvero tanti libri posso- 
no essere associati a un autore: 

<?xml version="1 .0"?> 

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 



" http://hibernate.sourceforge.net/hibernate-mapping-3. U.dtd"> 
<hibernate-mapping> 

<class name=" it.ioprogrammo.librodb.hibernate.Libri " table=" libri " 

catalog=" libro "> 

<id name="id" type="java.lang.lnteger"> 

<column name="ID" /> 

<generator class="identity" /> 
</id> 



<many-to-one name=" autore" 

class="it.ioprogrammo.librodb.hibernate.Autore" fetch="select"> 
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</many-to-one> 

<property name="isbn" type="string"> 

<column name="ISBN" length="45" not-null="true" /> 
</property> 

<property name="titolo" type="string"> 

<column name="TITOLO" length="45" not-null="true" /> 
</property> 

<property name=" categoria" type="string"> 

<column name="CATEGORIA" length="45" not-null="true" /> 
</property> 
</class> 
</hibernate-mapping> 

Il tag <many-to-one> ci permette, appunto, di definire questo nuovo ti- 
po di mapping, indicando a quale classe questa associazione si riferisce 
e quale colonna del database è interessata. Nella classe relativa non 
avremo più un oggetto di tipo String, ma il nuovo oggetto tutore: 

private Autore autore; 

Vediamo ora questo nuovo mapping. In questo caso vedremo un nuo- 
vo costrutto di Hibernate, l'insieme {set). Questo serve per gestire la re- 
lazione che esiste tra queste due tabelle, in maniera diametralmente 
opposta a quella relativa ai libri. 

<?xml version="1 .0"?> 

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 

DTD 3.0//EN" 

" http://hibernate.sourceforge.net/hibemate-mapping-3. 0.dtd "> 
<hibernate-mapping> 

<class name="it.ioprogrammo.librodb.hibemate.Autore" 

table= "autore " catalog= " libro " > 
<id name="id" type="java.lang.lnteger"> 
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<column name="ID" /> 



<generator class="identity" /> 
</id> 




<column name="NOME" length="45" not-null="true" /> 
</property> 

<property name=" cognome" type="string"> 



<column name="COGNOME" length="45" not-null="true" /> 
</property> 

<property name=" email" type="string"> 

<column name="EMAIL" length="45" not-null="true" /> 
</property> 

<set name="libris" inverse="true"> 
<key> 

<column name="ID_AUTORE" not-null="true" /> 

</key> 

<one-to-many class=" it.ioprogrammo.librodb.hibernate.Libri" /> 
</set> 
</class> 
</hibernate-mapping> 

L'autore può chiaramente aver scritto più libri, visto che la tabella AU- 
TORI ha una foreign key su libri. Questa situazione viene gestita con un 
insieme, dove viene specificato che la relazione è uno a molti, attraver- 
so il tag <one-to-many>. Questo nuovo mapping deve essere aggiun- 
to al nostro file hibernate.cfg.xml: 

<mapping resource="it/ioprogrammo/librodb/hibernate/Autore.hbm.xml" 

/> 

Per completare tutto il nostro viaggio nelle associazioni adesso dobbia- 
mo vedere anche la classe/autore, dove avremo un Set tjava.util.HashSet 
per la precisione) che gestisce l'insieme di libri associati ad un determi- 



60 



I libri di ioPROGRAMMo/Java e Database 



Capitolo 2 



H IBERNATE 



JAVA 

E DATABASE 



nato autore. 

package it.ioprogrammo.librodb.hibernate; 

import java.util.HashSet; 
import java. util. Set; 

public class Autore implements java.io.Serializable { 

private Integer id; 
private String nome; 
private String cognome; 
private String email; 
private Set libris = new HashSet(O); 

public Autore() { 

} 

public Autore(String nome, String cognome, String email) { 
this.nome = nome; 
this.cognome = cognome; 
this.email = email; 

} 

public Autore(String nome, String cognome, String email, Set libris) { 
this.nome = nome; 
this.cognome = cognome; 
this.email = email; 
this.libris = libris; 

} 

public Integer getld() { 
return this.id; 

} 
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public void setld(lnteger id) { 
this.id = id; 



public String getNome() { 
return this.nome; 

} 

public void setNome(String nome) { 
this.nome = nome; 

} 

public String getCognome() { 
return this.cognome; 

} 

public void setCognome(String cognome) { 
this.cognome = cognome; 

} 

public String getEmail() { 



} 

public void setEmail(String email) { 
this.email = email; 

} 

public Set getLibris() { 
return this.libris; 

} 
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this.libris = libris; 

} 



} 



Il funzionamento di questo nuovo mapping, a livello di creazio- 
ne/ricerca/salvataggio/cancellazione è simile al precedente. Chiaramen- 
te, però, non possiamo ora creare un libro ex-novo senza collegare ad 
esso un oggetto tutore. Nel codice seguente vediamo come creare un 
oggetto tutore, associarlo a un autore già esistente e salvare il tutto: 

package it.ioprogrammo.librodb.hibernate; 

import java.util.lterator; 
import java. util. List; 



import org.hibernate.Criteria; 
import org.hibernate.Session; 
import org.hibernate.SessionFactory; 
import org.hibernate.cfg.Configuration; 
import org.hibernate.criterion.Example; 

public class TestAssociazioni { 

public static void main(String[] args) { 
SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.getCurrentSession(); 
session.beginTransactionO; 
Autore autore=new Autore(); 
autore.setNome(" Federico"); 
autore.setCognome("Paparoni"); 
Example autoreExample; 
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autoreExample=Example.create(autore); 

Criteria criteria = session.createCriteria(Autore.class); 

criteria.add(autoreExample); 

autore=(Autore)criteria.un iq ueResult(); 

Libri librai =new Libri(); 

librai .setAutore(autore); 

librai .setCategoriaf IT/Database"); 

librai .setlsbn(" 1 234567890 "); 

librai .setTitolof Java e database"); 

Libri libro2=new Libri(); 

libro2.setAutore(autore); 

libro2.setCategoria(" IT/OS"); 

Iibro2.setlsbn("0987654321 "); 

libro2.setTitolo("0perating Systems"); 

session.save(librol); 

session.save(libro2); 

session.getTransaction().commit(); 

} 



In una prima fase abbiamo cercato l'autore, già presente sul database, 
utilizzando una ricerca By Example. Successivamente abbiamo creato 
due nuovi libri e, dopo aver settato l'autore trovato, li abbiamo memo- 
rizzati su database. Il risultato di questo programma lo potete vedere nel- 
la seguente immagine, dove sono presenti due entry nella tabella libri, 
con ID_AUTORE uguale. 

Questo che abbiamo visto non è l'unico modo in cui Hibernate gestisce 
le associazioni/collezioni, diciamo che è quello più vicino al mondo re- 
lazionale. Chiaramente, anche dal punto di vista delle ricerche, possia- 
mo sfruttare le associazioni presenti tra diversi oggetti. 
Ad esempio, se volessimo recuperare dal database tutti gli autori che han- 
no scritto libri di una particolare categoria potremmo definire il seguen- 
te Criteria: 
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Figura 2.3: Il risultato dell'associazione che abbiamo realizzato 



session.createCriteria(Autore.class) 
.createCriteria("libris", "libri") 
.add(Expression.eq("libri.categoria", "IT/Database")) 
■listO; 



s 



Utilizzando il metodo createCriteriaQ, in questo caso, abbiamo inco- 
minciato ad inserire delle restrizioni sull'associazione che Autore ha 
con Libri. A livello pratico è come fare una join tra le due tabelle, speci- 
ficando un certo valore che ci permette di ottenere i risultati voluti. 
Quando affrontiamo questo argomento dobbiamo fare molta attenzio- 
ne ai diversi modi in cui poter caricare i dati relativi alle associazioni, 
perché giustamente potremmo avere dei problemi di performance. Hi- 
bernate per risolvere questo problema offre il meccanismo del lazyfet- 
ching, che ci permette di caricare in un secondo momento i dati di cui 
abbiamo bisogno. Per questa tematica e per altre che possono aiutare 
il tuning della vostra applicazione con Hibernate vi rimando alla docu- 
mentazione ufficiale. 



EREDITARIETÀ' 

Hibernate è un framework che ci permette di mappare il nostro mondo 
Object Oriented in un sistema relazionale come quello dei database. 
Oltre alle associazioni, una delle cose che possono essere più di diffici- 
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li da trasformare in un modello relazionale è l'ereditarietà, la gerarchia 
che abbiamo tra le diverse classi che vengono utilizzate nel nostro pro- 
getto. Essendo un ORM, Hibernate ha chiaramente delle soluzioni an- 
che per questo problema, infatti ci sono diversi modi in cui possiamo 
risolvere questo problema. Ora vedremo 3 diversi metodi, che vengono 
elencati qui di seguito 

• Una tabella per sottoclasse 

• Una tabella per gerarchia di classe 

• Una tabella per classe concreta 

Vediamo, quindi, la prima situazione, in cui abbiamo una classe princi- 
pale, dalla quale vengono estese 3 diverse classi che utilizzeremo nel no- 
stro progetto. Nella prossima immagine potete vedere le classi d'esempio 
che abbiamo utilizzato: 



Veicolo 

A 



auto 



Camion 



Moto 



Figura 2.3: Primo esempio di ereditarietà 



In questo esempio abbiamo una classe base, veicolo 



package it.ioprogrammo.librodb.hibernate; 



public class Veicolo { 



66 I libri di ioPROGRAMMO/Java e Database 



Capitolo 2 



H IBERNATE 



JAVA 

E DATABASE 



public int getld() f 
return id; 



public void setld(int id) i 
this.id = id; 

} 



} 



e tre sottoclassi: Automobile, Camion e Moto 

package it.ioprogrammo.librodb.hibernate; 

public class Automobile extends Veicolo { 
String marca; 

public String getMarca() { 
return marca; 

} 



public void setMarca(String marca) { 
this.marca = marca; 



package it.ioprogrammo.librodb.hibernate; 
public class Camion extends Veicolo { 
int portata; 

public int getPortata() { 
return portata; 
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} 

public void setPortata(int portata) { 



} 

} 

package it.ioprogrammo.librodb.hibernate; 

public class Moto extends Veicolo { 
int cilindrata; 

public int getCilindrataO { 
return cilindrata; 

} 

public void setCilindrata(int cilindrata) { 
this.cilindrata = cilindrata; 

} 

In questo tipo di situazione vogliamo creare un mapping che genera 
una tabella per ogni sottoclasse, anche perché non ci sono valori da 
mappare nella classe padre Veicolo oltre all'id. Quest'ultimo verrà map- 
pato in una tabella a cui tutte le tabelle relative alle sottoclassi dovran- 
no far riferimento. Per fare questo dobbiamo creare una tabella VEICO- 
LO che avrà il solo ID, mentre le altre tabelle avranno tutti i valori di lo- 
ro competenza, con una colonna ID che sarà un Foreign Key legata al- 
la tabella ID di VEICOLO. Riportiamo ora l'SQL che serve a creare que- 
ste quattro tabelle sul nostro database MySQL: 
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TD' INTEGER UNSIGNED NOT NULL DEFAULT NULL AUTOJNCREMENT, 
PRIMARY KEY fID') 

) 

ENGINE = lnnoDB; 



CREATE TABLE "libro' .'automobile ( 
'ID' INTEGER UNSIGNED NOT NULL, 
'MARCA' VARCHAR(45) NOT NULL, 

CONSTRAINT 'FKjutomobileJ' FOREIGN KEY "FK_automobile_1" (TD') 
REFERENCES 'veicolo' f ID') 
ON DELETE CASCADE 
ON UPDATE CASCADE 

ENGINE = InnoDB; 

3 

CREATE TABLE 'libro' .'camion' ( 
'ID' INTEGER UNSIGNED NOT NULL, 
'PORTATA' INTEGER UNSIGNED NOT NULL, 
CONSTRAINT "FK_camion_1" FOREIGN KEY FK_camion_1" ('ID') 

REFERENCES "veicolo" f ID") 

ON DELETE CASCADE 

ON UPDATE CASCADE 

) 

ENGINE = InnoDB; 



CREATE TABLE "libro" ."moto" ( 
'ID' INTEGER UNSIGNED NOT NULL, 
'CILINDRATA' INTEGER UNSIGNED NOT NULL, 
CONSTRAINT 'FK_moto_1" FOREIGN KEY 'FK_moto_1' ('ID') 

REFERENCES 'veicolo' f ID") 

ON DELETE CASCADE 

ON UPDATE CASCADE 
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Ora che abbiamo definito nei due diversi mondi, relazionale e 00, co- 
me gestire le nostre informazioni, dobbiamo istruire Hibernate su co- 
me gestire il mapping. Per fare ciò dovremo come sempre definire un fi- 
le XML di mapping: 

<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 

DTD3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping> 
<class name="it.ioprogrammo.librodb.hibernate. Veicolo" 

table="veicoio" polymorphism= " implicit" > 
<id name="id" column="ID"> 
<generator class="native"/> 
</id> 

<joined-subclass name="it.ioprogrammo.librodb.hibernate.Automobile" 

table="automobile"> 

<key column="ID7> 

<prope rt y name="marca" colu m n=" marca" type="ja V a.lang.String" 

/> 

</joined-subclass> 

<joined-subclass name= " it.ioprogrammo.librodb.hibernate.Camion " 

table="camion"> 

<key column="ID"/> 

<property name=" portata" column=" portata" type="int" /> 
</joined-subclass> 

<joined-subclass name="it.ioprogrammo.librodb.hibernate.Moto" 



table="moto"> 

<key column="ID"/> 




70 



I libri di ioPROGRAMMo/Java e Database 



Capitolo 2 



H IBERNATE 



JAVA 

E DATABASE 



</joined-subclass> 
</class> 
</hibernate-mapping> 

Questo file di mapping introduce delle novità rispetto a quelli che abbia- 
mo visto fino a questo punto. All'interno della classe Veicolo, mappa- 
ta sulla rispettiva tabella, possiamo vedere che ci sono una serie di sot- 
toclassi definite con il tagjoined-subclass. In questo modo Hibernate 
è a conoscenza dei collegamenti tra classi e tabelle, altresì è conscio 
che quando si inserisce un nuovo Veicolo nella tabella omonima, suc- 
cessivamente dovrà fare una seconda insert nella tabella relativa alla 
sottoclasse, utilizzando l'ID della tabella veicolo. Vediamo, quindi, un 
esempio di codice da utilizzare con questo mapping: 

package it.ioprogrammo.librodb.hibernate; 

import org.hibernate.Session; 
import org.hibemate.SessionFactory; 
import org.hibernate.cfg.Configuration; 

public class AssociazioneUno { 

public static void main(String[] args) { 
SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.getCurrentSession(); 
session.beginTransactionO; 

Moto moto=new Moto(); 
moto.setCilindrata(250); 
Camion camion=new Camion(); 
camion.setPortata(200); 
Automobile auto=new Automobile(); 
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auto.setMarcaf ROVER"); 



session.save(moto); 



session.save(auto); 
session.getTransaction().commit(); 



La classe d'esempio qui riportata inserisce tre diversi veicoli nel nostro 
database. Dietro le quinte Hibernate esegue i seguenti comandi SQL 
(che possiamo vedere dal log settando a true la proprietà hiberna- 
te.show_sql nel file di configurazione) 



Hibernate: insert into veicolo values ( ) 

Hibernate: insert into moto (cilindrata, ID) values (?, ?) 

Hibernate: insert into veicolo values ( ) 

Hibernate: insert into camion (portata, ID) values (?, ?) 

Hibernate: insert into veicolo values ( ) 

Hibernate: insert into automobile (marca, ID) values (?, ?) 



Come avevamo già preannunciato, Hibernate inserisce prima una nuo- 
va riga nella tabella veicolo e successivamente effettua l'insert nella ta- 
bella relativa alla sottoclasse, riportando 1*1 D della nuova riga di veico- 
lo appena creata. Passiamo ora a una diversa soluzione per questo pro- 
blema, quella che ci suggerisce di utilizzare una tabella per ogni gerar- 
chia di classe. Praticamente, utilizzando questo metodo, dovremmo ave- 
re una tabella che mappa concettualmente tutta una nostra gerarchia. 
Da un certo punto di vista questa potrebbe essere la soluzione più pra- 
tica, anche se come primo problema abbiamo che all'interno di questa 
tabella non tutte le colonne saranno valorizzate, visto che saranno pre- 
senti tante colonne quanti sono i vari parametri di tutte le sottoclassi del- 
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Telefono 

+id: int 

-Ji.ac-riiPirL3-.---i : 3'..?Lr.~ 



I 













TelefònoFIsso 




TelefonoCellulare 




" - * ■> - ~- - - - ■ * - - - 




Per capire meglio anche questa soluzione, partiamo da un altro esem- 
pio, con una classe padre Telefono: 



package it.ioprogrammo.librodb.hibernate; 

public class Telefono { 
int id; 

String numero; 
String discriminator; 

public int getld() { 
return id; 

} 

public void setld(int id) { 



I libri di ioPROGRAMMO/Java e Database 



73 



JAVA 
E DATABASE 



HIBERNATE 



Capitolo 2 



this.id = id; 



} 



public String getNumero() | 



} 

public void setNumero(String numero) { 
this.numero = numero; 

} 

public String getDiscriminator() { 
return discriminator; 

} 

public void setDiscriminator(String discriminator) { 
this.discriminator = discriminator; 

} 



e due classi che la estendono, TelefonoFisso e TelefonoCellulare: 



package it.ioprogrammo.librodb.hibernate; 



public class TelefonoFisso extends Telefono { 



ng. 



public String getDistretto() { 
return distretto; 

} 



public void setDistretto(String distretto) f 
this.distretto = distretto; 

} 



74 



I libri di ioPROGRAMMo/Java e Database 



Capitolo 2 



H IBERNATE 



JAVA 

E DATABASE 



package it.ioprogrammo.librodb.hibernate; 

public class TelefonoCellulare extends Telefono { 
String pianoTariffario; 

public String getPianoTariffarioO { 
return pianoTariffario; 

} 

public void setPianoTariffario(String pianoTariffario) { 
this.pianoTariffario = pianoTariffario; 

} 

} 

Ognuna delle due classi figlie ha un parametro particolare che la carat- 
terizza e che l'altra classe non deve gestire. Come abbiamo detto, in 
questa metodologia vogliamo utilizzare una sola tabella per mappare 
tutta una gerarchia di classi. Per definire la tabella sul nostro database, 
dobbiamo renderci conto che ci saranno tutti i valori possibili relativi al- 
la gerarchia e in più una colonna che servirà a Hibernate per effettuare 
la distinzione sulla diversa tipologia di classe. Vediamo la definizione di 
questa tabella: 

CREATE TABLE 'libro' .'telefono' ( 
'ID' INTEGER UNSIGNED NOT NULL AUTOJNCREMENT, 
'DISCRIMINATOR' VARCHAR(45) NOT NULL, 
'NUMERO' VARCHAR(45) NOT NULL, 
'PIANOTARIFFARIO' VARCHAR(45), 
'DISTRETTO' VARCHAR(45), 
PRIMARY KEY ('ID') 

) 

ENGINE = lnnoDB; 
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Abbiamo inserito la colonna DISCRIMINATOR per capire a livello di en- 
try quale sia la classe di pertinenza. Chiaramente non lo dovremo fare 
noi a mano, ma sarà Hibernate che in base al file di mapping che defi- 
niremo, riempirà questa colonna con il valore relativo alla rispettiva clas- 
se. 

<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 

DTD3.0//EN" 

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping> 
<class name="it.ioprogrammo.librodb.hibernate.Telefono" 

table= "TELEFONO" polymorphism= " implicit" > 
<id name="id" column="ID"> 
<generator class="native"/> 
</id> 

<discriminator> 
<column name="DISCRIMINATOR"/> 
</discriminator> 

<property name=" numero" column="NUMERO" 

type="java.lang.String"/> 

<subclass name="it.ioprogrammo.librodb.hibernate.TelefonoCellulare" 
discriminator-value="TelefonoCellulare"> 
<property name="pianoTariffario" column="PIANOTARIFFARIO" 

type="java.lang.String" /> 

</subclass> 



<subclass name="it.ioprogrammo.librodb.hibernate.TelefonoFisso" 

discriminator-value="TelefonoFisso"> 
<property name="distretto" column=" DISTRETTO" 




76 



I libri di ioPROGRAMMo/Java e Database 



Capitolo 2 



H IBERNATE 



JAVA 

E DATABASE 



</subclass> 
</class> 
</hibernate-mapping> 



In questo mapping abbiamo definito il tag <discriminator>, settando- 
gli il valore della colonna DISCRIMINATOR. Così facendo, Hibernate 
per capire con quale tipo di classe sta operando dovrà far riferimento al 
valore di quella colonna. Nel momento in cui andiamo a salvare un nuo- 
vo oggetto, Hibernate utilizzerà il valore di discriminator che abbiamo 
definito per la classe di quell'oggetto. Continuando a vedere il file di 
mapping possiamo notare che in questo caso le classi, tranne quella 
padre, vengono definite all'interno di tag <subclass>, dove vengono ri- 
portate le proprietà delle singole classi. Oltre a questo viene inserito co- 
me attributo di subclass il discriminator-value, che sarà il valore uti- 
lizzato per discriminare tra i diversi tipi di sottoclasse definiti. Vediamo 
quindi un esempio che inserirà due diversi oggetti, settando i relativi 
attributi di classe, lasciando vuoti nella riga quelli che non sono di sua 
pertinenza e settando il valore del discriminator: 

SessionFactory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.getCurrentSession(); 
session. beginTransactionQ; 



TelefonoCellulare cell=new TelefonoCellulare(); 
celI.setNumerof 12345678909"); 
cell. setPianoTariffariof Piano famiglia"); 
TelefonoFisso fisso=new TelefonoFisso(); 
fisso.setNumero(" 123123123123 "); 
fisso.setDistretto(" Roma " ); 



session. save(cell); 
session. save(fisso); 
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Anche in questo caso, se abbiamo configurato tutto per bene, iberna- 
te lavorerà dietro le quinte per organizzare gli inserimenti nella singo- 
la tabella TELEFONO, settando gli opportuni valori. La terza via che 
possiamo intraprendere per mappare una gerarchia di classi, ovvero 
quella in cui andiamo a utilizzare una tabella per ogni classe concreta 
del nostro dominio. In questo caso quando andiamo a parlare di classe 
"concreta", parlando di gerarchia di classi, ci riferiamo alle classi figlie 
non astratte che utilizzeremo nel nostro progetto. Infatti con questa ul- 
tima tecnica avremo una tabella per ognuna di queste classi. La classe 
"non concreta" potrebbe essere, ad esempio, una classe padre che ab- 
biamo definito astratta, come la seguente: 

package it.ioprogrammo.librodb.hibernate; 

public abstract class Programmi { 
int id; 

String nome; 
public int getld() { 
return id; 



public void setld(int id) { 
this.id = id; 

} 

public String getNome() { 
return nome; 

} 

public void setNome(String nome) { 
this.nome = nome; 

} 

} 
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Nel codice, ai fini della logica del nostro programma, abbiamo deciso di 
definire questa classe astratta perché avremo bisogno di utilizzare so- 
lo le classi figlie Videogiochi e OfficeSoftware 

package it.ioprogrammo.librodb.hibernate; 

public class Videogiochi extends Programmi { 
String categoria; 

public String getCategoria() { 
return categoria; 

} 

public void setCategoria(String categoria) { 
this.categoria = categoria; 

} 

} 



package it.ioprogrammo.librodb.hibernate; 

public class OfficeSoftware extends Programmi { 
String licenza; 

public String getLicenza() { 
return licenza; 

} 

public void setLicenza(String licenza) { 
this.licenza = licenza; 
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Le due entità che ci interessa mappare sono quindi delle classi figlie di 
Programmi, ma che comunque andranno ad essere inserite su due di- 
verse tabelle. Quest'ultime avranno chiaramente delle colonne differen- 
ti, ma dovremo avere l'accortezza di scegliere un nome uguale per quan- 
to riguarda la colonna dell'identificativo, perché questo dovrà essere 
condiviso tra le due tabelle. 

CREATE TABLE 'libro' .'VIDEOGIOCHI' ( 
'ID_PROG' INTEGER UNSIGNED NOT NULL AUTOJNCREMENT, 
'CATEGORIA VARCHAR(45) NOT NULL, 
'NOME' VARCHAR(45) NOT NULL, 
PRIMARY KEY ('ID.PROG') 

) 

ENGINE = InnoDB; 

CREATE TABLE 'libro' .'OFFICESOFTWARE' ( 
ID„PROG' INTEGER UNSIGNED NOT NULL AUTOJNCREMENT, 
'LICENZA' VARCHAR(45) NOT NULL, 
'NOME' VARCHAR(45) NOT NULL, 
PRIMARY KEY ('ID.PROG') 

) 

ENGINE = InnoDB; 



Ogni tabella ha una colonna ID_PROG che utilizza come chiave prima- 
ria, nel nostro caso si tratterà di una chiave primaria "condivisa", per- 
ché a livello logico non esisteranno due "Programmi" con lo stesso iden- 
tificativo. Vediamo ora come istruire Hibernate questo nuovo mapping 

<?xml version="1 .0"?> 

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping 

DTD3.0//EN" 

" http://hibernate.sourceforge.net/hibernate-mapping-3. 0.dtd"> 
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<class name="it.ioprogrammo.librodb.hibernate.Programmi" 

abstract="true"> 

<id name="id" column="ID_PROG"> 
<generator class="increment"/> 

</id> 

<property name="nome" column="NOME" type= " java.lang.String " 

/> 

<union-subclass name= " it.ioprogrammo. 

librodb.hibernate. Videogiochi" table="VIDEOGIOCHI"> 
<property name="categoria" column=" CATEGORIA" 

type="java.lang.String" /> 

</union-subclass> 

<union-subclass name= " it.ioprogrammo. 

Iibrodb.hibernate.0ffice5oftware" table="OFFICESOFTWARE"> 
<property name="licenza" column=" LICENZA" 

type="java.lang.String" /> 

</union-subclass> 
</class> 
</hibernate-mapping> 

La classe padre, Programmi, è stata definita come abstract, infatti non 
viene definita nessuna tabella relativa. L'unica cosa che è relativa alla clas- 
se padre è la property nome, che troviamo in entrambe le tabelle, e l'id 
che viene associato alla colonna ID_PROG. Le sottoclassi di questa ge- 
rarchia vengono definite con il tag <union-subclass>, dove viene ri- 
portata anche la tabella che si occuperà di questa sottoclasse. Oltre a que- 
ste tre maniere per effettuare il mapping di una gerarchia, possiamo 
anche utilizzare altri metodi, che talvolta possono essere la risultante di 
una combinazione tra quelli che abbiamo visto qui. In ogni caso biso- 
gna vedere come poter applicare questi metodi alla nostra applicazio- 
ne o come quest'ultima deve essere cambiata per adottarne uno. 
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LA GESTIONE DELLA CACHE 

Visto che quando utilizziamo framework come Hibernate stiamo co- 
munque parlando di gestire dati in qualche maniera, un argomento che 
deve essere affrontato di sicuro è quello relativo alla cache. Le presta- 
zioni sono importanti nel nostro lavoro, specialmente quando parliamo 
di accesso ai dati, quindi vale la pena spendere un po' di tempo a par- 
lare dei diversi modi in cui Hibernate gestisce il caching. Esistono all'in- 
terno di questo framework diversi modi per abilitare la cache dei dati. 
Prima di tutto dobbiamo sapere che la classe Session, fondamentale 
per tutte le operazioni, gestisce una sua cache relativa alla singola tran- 
sazione che andiamo ad effettuare. Praticamente gli oggetti salvati e 
caricati dalla Session, rimangono in questa cache fino a quando la tran- 
sazione non viene terminata. Per renderci conto di questo comporta- 
mento possiamo vedere il seguente esempio: 

package it.ioprogrammo.librodb.hibernate; 



import org.hibernate.Session; 
import org.hibernate.SessionFactory; 
import org.hibernate.cfg.Configuration; 




public static void main(String[] args) throws Exception { 
Session Factory sessionFactory=new 

Configuration().configure().buildSessionFactory(); 
Session session=sessionFactory.getCurrentSession(); 
session. beginTransactionQ; 



Videogiochi test=new Videogiochi(); 
test.setCategoria("RUOLO"); 
test.setNome( "Magic The Gathering "); 
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session.save(test); 

System. out.println("Chiamato save sull'oggetto"); 
Thread.currentThread().sleep(8000); 
session.getTransaction().commit(); 
System. out.println(" Chiamato commit"); 



} 



In questa classe abbiamo creato un nuovo oggetto, l'abbiamo salvato 
e successivamente abbiamo inviato la commit sulla transazione. 
Se andiamo a vedere i log possiamo renderci conto di quello che acca- 
de: 

Oggetto creato 

Hibernate: select max(ids_.ID_PROG) from ( select ID_PR0G from OF- 
FICESOFTWARE union select ID_PROG from VIDEOGIOCHI ) ids_ 
Chiamato save sull'oggetto Hibernate: insert into VIDEOGIOCHI (NO- 
ME, CATEGORIA, ID_PROG) values (?, ?, ?) 
Chiamato commit 

2 

Praticamente, quando chiamiamo il metodo saveQ di Sessìon, Hiberna- 
te si preoccupa di avere tutte le info che gli servono per avere un ogget- 
to che può essere memorizzato (in questo caso l'id visto che stiamo uti- 
lizzando una union-class). Solo successivamente, quando viene richia- 
mato il metodo commitQ, Hibernate inserisce effettivamente l'entry nel 
database. Per essere più sicuri potete anche vedere che durante la sleepO 
l'entry ancora non è inserita nel database (con MySQL potete vederlo uti- 
lizzando MySQL Query Browser). Questo comportamento non è un bug 
ma è una cosa voluta. Immaginiamo di aprire una sessione, creare un'og- 
getto, salvarlo, successivamente modificarlo ed infine chiudere la sessio- 
ne. Hibernate, giustamente, risparmia i diversi statement SQL che dovreb- 
be inviare al database per ottimizzare le prestazioni del nostro program- 
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ma. Gli oggetti in questa cache possono essere comunque rimossi uti- 
lizzando i metodi evictQ, dearQ e flushQ di Session. All'interno di iber- 
nate è presente anche StatelessSession, che è una versione modifica- 
ta di Session in cui non è presente la cache di primo livello che abbia- 
mo visto ora. Oltre a questo tipo di cache esiste anche quella che viene 
definita di secondo livello, che è possibile utilizzare a livello di cluster o 
differenti JVM. Per abilitare questo tipo di cache, dobbiamo scegliere 
una delle varie implementazioni disponibili all'interno di Hibernate op- 
pure costruirne una noi. Quelle che possiamo utilizzare implementano 
l'interfaccia org.hibernate.cache. Cache e hanno caratteristiche diver- 
se. Infatti diverse implementazioni sono degli adattamenti di altri pro- 
getti opensource, che hanno implementato l'interfaccia Cache. Qui di se- 
guito viene riportata la lista di cache disponibili 

• org.hibernate.cache. EhCache Plugin di EhCache per Hibernate. 
http://ehcache.sourceforge.net 

• org. hibernate. cache. HashtableCache Un'implementazione 
"leggera", che dovrebbe essere utilizzata solo in ambito di svilup- 
po 

• org.hibernate.cache.OSCache: Plugin di OSCache, software di 
Opensymphony, per Hibernate. httpS/www.opensymphony.com/oscache 

• org.hibernate.cache.SwarmCache: Plugin di SwarmCache, pro- 
getto opensource disponibile su http://swarmcache.sourceforge.net 

• org.hibernate.cache.TreeCache: La soluzione TreeCache di JBos- 
sCache 

• org.hibernate.cache.OptimisticTreeCache Altro plugin di Tree- 
Cache che implementa diverse funzionalità 

Nella seguente immagine vengono riportata le differenti caratteristiche 
delle cache che possiamo utilizzare con Hibernate. 
Il tipo di cache riguarda il modo in cui vengono memorizzati i dati, in me- 
moria, su disco o in ambiente cluster. La Query Cache è un'altra tipo- 
logia di cache di cui parleremo in seguito, mentre nelle seguenti colon- 
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Figura 2.6: Caratteristiche delle cache di Hibernate 



ne vengono riportati i quattro diversi livelli di accesso che le cache sup- 
portano. Questi livelli servono per capire che tipo di concorrenza possia- 
mo avere sui dati 



Read-only: Questo livello viene utilizzato quando dobbiamo sol- 
tanto leggere i dati. Chiaramente è uno di quelli più performanti 
Read-write: In questo caso abbiamo bisogno di utilizzare gli ogget- 
ti sia in lettura che in scrittura 

Strict read-write: Quando non c'è un eccessivo bisogno di ag- 
giornare i dati e questa operazione viene eseguita occasionalmen- 
te allora il livello che ci interessa è esattamente questo 
Transactional: Il supporto per un livello completamente transa- 
zionale viene dato dai provider che supportano questa strategia di 
concorrenza 



Il discorso relativo alle cache è molto dipendente dalle operazioni che 
vengono effettuate nella nostra applicazione, quindi nella maggior par- 
te dei casi dobbiamo provare diverse soluzioni prima di trovare quella 
più performante per la nostra applicazione. Vediamo ora come abilita- 
re una cache di secondo livello per i nostri dati. La prima operazione da 
fare è quella di abilitare la cache, dicendo ad Hibernate nel file di con- 
figurazione che siamo interessati ad utilizzare una tra le implementazio- 
ni disponibili: 
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<property name= " hibernate.cache.provider_class " > 
org.hibernate.cache.OSCacheProvider 



opertp 



<property name= " hibernate.cache.use_second_level_cache " > 
true 



Poi abilitiamo il caching direttamente nel file di mapping della risorsa che 
vogliamo abilitare 

<cache usage="read-only7> 

A questo punto abbiamo detto ad Hibernate che vogliamo la cache di 
secondo livello, che abbiamo scelto l'implementazione di OSCache e 
che la gerarchia Programmi (dove abbiamo inserito il tag cache) verrà 
gestita con una cache read-only. In questo modo abbiamo abilitato il se- 
condo tipo di cache, le prestazioni della vostra applicazione potrebbe- 
ro cambiare molto con una strategia di caching giusta. Come ultimo 
argomento vediamo ora l'ultima tipologia di cache disponibile su Hi- 
bernate, la Query Cache. Quando vengono effettuate alcune query c'è 
la possibilità di effettuare il caching, ma non dei risultati, bensì delle as- 
sociazioni tra query e identificativi degli oggetti. Anche in questo caso 
dobbiamo capire se per la nostra applicazione questo tipo di cache può 
essere di qualche giovamento, senza magari abilitare cose che poi non 
cambiano assolutamente le performance. Per quanto riguarda la cache 
ed altre modifiche alla configurazione che possono migliorare sensibil- 
mente le performance della nostra applicazione vi rimando alla seguen- 
te pagina ufficiale della documentazione http://www.hibernate.org/hib_ 
docs/v3/reference/en/html/perf ormance.html, che potete anche tro- 
vare nella distribuzione di Hibernate che avete scaricato sul vostro pc, 
all'interno della sottodirectory doc. 
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Un framework famoso e utilizzato come Hibernate ha spinto molti svi- 
luppatori a realizzare dei tool che possono aiutarci. Vengono qui ripor- 
tati alcuni tool che possiamo utilizzare insieme ad Hibernate 

• Hibernate Tools: Un plugin per FIDE Eclipse, una serie di task Ant 
e una console per il database che possono risultare utili - 
http://tools.hibernate.org 

• NbXdoclet: Un plugin per l'I DE Netbeans, che ci permette di ave- 
re tutte le funzionalità base di Hibernate all'interno di questo IDE - 
http://nbxdoclet.sourceforge.net 

• AndroMDA: Genera il codice a partire da diagrammi UML e Hi- 
bernate può essere integrato -http://www.andromda.org 



S 
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iBatis è un framework per il data mapping realizzato da Clin- 
ton Begin e che ora viene gestito come progetto opensource da 
Apache (http://ibatis.apache.org). Rispetto ad altri framework, 
come Hibernate, iBatis presenta una soluzione che viene detta 
ibrida, tra l'ORM e il classico SQL. Utilizzando questo framework, 
infatti, vedremo come esso sia proprio una sorta di middlewa- 
re tra le nostre applicazioni e i database, senza interferire trop- 
po nei rispettivi domini. Il problema classico dei tool ORM è 
quello che i due mondi, l'OO e i database, sono alcune volte 
molto diversi. 

Spesso succede che quando ci appoggiamo troppo ad un ORM 
dobbiamo stravolgere il database e viceversa. iBatis cerca di 
proporsi come una soluzione per diverse situazioni applicative, 
permettendo di cablare il codice SQL all'esterno della nostra ap- 
plicazione ma preservando comunque una definizione diretta 
dei vari comandi SQL. In questo modo possiamo utilizzare il me- 
glio di entrambi i mondi senza venire a compromessi. Inoltre 
possiamo dire che utilizzando questo progetto riusciamo a indi- 
viduare i giusti limiti di responsabilità all'interno di un proget- 
to. Utilizzando altri progetti dobbiamo occuparci al tempo stes- 
so del dominio Object Oriented e della sua rappresentazione 
nel modello relazionale. In questo modo possiamo anche parti- 
re da uno schema già esistente e cercare di applicarlo al nostro 
progetto. Come altri tool dello stesso genere, iBatis basa tutto 
sulla sua configurazione che permette di definire prima di tutto 
il modo in cui dobbiamo collegarci al nostro database. Oltre a que- 
sto, come nel caso di Hibernate, ci permette di definire diversi ti- 
pi di mapping, ma in questo caso la definizione cambia il suo 
significato come avremo modo di vedere. La seguente immagi- 
ne riassume bene il mondo di iBatis 
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Figura 3.1: Architettura di iBatis 



Attraverso un input, che può essere un tipo primitivo, un oggetto o un 
hash, il motore di iBatis elabora la richiesta che gli facciamo, basando- 
si sulla propria configurazione di accesso e di mapping. iBatis è un fra- 
mework che attualmente ha diverse implementazioni per diversi lin- 
guaggi: Java, Ruby, C#. Chiaramente in questo libro ci dedicheremo a quel- 
la relativa a Java, però il fatto di avere implementazioni simili in altri lin- 
guaggi è comunque un pregio da ricordare. 

CONFIGURAZIONE 

Come punto di partenza per ogni tool dobbiamo capire il modo in cui 
questo viene configurato. Riportiamo qui di seguito la configurazione per 
la prima prova che faremo con iBatis 



<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE sqlMapConfig PUBLIC "-//iBATIS.com//DTD SQL Map 

Config2.0//EN" 
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<sqlMapConfig> 
<properties 

resource="it/ioprogrammo/librodb/ibatis/SqlMapConfig.properties" /> 
<settings 

cacheModelsEnabled="true" 

enhancementEnabled="true" 

lazyLoadingEnabled="tme" 

maxRequests="32" 

maxSessions="10" 

maxTransactions="5" 

useStatementNamespaces= "false" 

/> 

<typeAlias alias=" utente" 

type="it.ioprogrammo.librodb.ibatis.Utente"/> 
<transactionManager type="JDBC" > 
<dataSource type="SIMPLE"> 

<property name="JDBC. Driver" value="${driver}"/> 
<property name="JDBC.ConnectionURL" value="${url}"/> 
<property name="JDBC.Username" 

value= " ${username}"/> 
<property name="JDBC. Password" value="${password}"/> 
</dataSource> 
</transactionManager> 

<sqllVlap resource="it/ioprogrammo/librodb/ibatis/Utente.xml" /> 
</sqlMapConfig> 

Analizziamo ora passo passo tutte le informazioni contenute in questo 
file di configurazione. Prima di tutto viene definito un file di properties, 
SqlMapConfig.properties, che verrà incluso ed utilizzato da iBatis. 
All'interno di questo file possiamo inserire ad esempio le informazioni 
JDBC per la connessione al database. Nel nostro caso il contenuto di que- 
sto file è il seguente: 
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driver=com.mysql.jdbc.Driver 
url=jdbc:mysql://1 27.0.0.1 /libro 
username=root 
password=mysql 

Nel file di configurazione ogni proprietà definita altrove tramite file di 
properties viene richiamata utilizzando la seguente sintassi: 

${NOMEVALORE} 

Passiamo ora al tag settings. All'interno sono definiti tutti i settaggi re- 
lativi all'istanza di iBatis che prenderà in pasto questa configurazione. 
Vediamo il significato di ognuno di questi valori 

• cacheModelsEnabled Come già abbiamo visto con Hibernate, 
anche iBatis permette di abilitare una sorta di cache per i dati gesti- 
ti. In seguito vedremo in dettaglio come utilizzare questa feature 

• enhancementEnabled Permette di utilizzare cglib, una libreria 
opensource, per ottimizzare le prestazioni in particolari situazioni 

• lazyLoadingEnabled Abilitando questo flag è possibile caricare 
determinati dati in maniera lazy, ovvero solo quando servono e non 
subito 

• maxRequests: Richieste massime attive allo stesso momento 

• maxSessions: Sessioni attive allo stesso momento 

• maxTransactions Transazioni attive allo stesso momento 

• useStatementNamespaces Serve per abilitare i namespace per 
richiamare le funzionalità di mapping 

Andando avanti nel file di configurazione troviamo la seguente riga: 

<typeAlias alias= 11 utente 11 type="it.ioprogrammo.librodb.ibatis.Utente"/> 



che definisce semplicemente un alias utilizzato all'interno del file, per non 
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dover utilizzare in diversi casi il nome completo della classe ma solo 
l'alias. Successivamente viene definito il modo in cui iBatis deve colle- 
garsi al database, attraverso la definizione in questo caso di una sem- 
plice connessione JDBC della quale vengono riportati tutti i parametri. 
In altre situazioni è possibile utilizzare JTA per avere un container che 
gestisce le transazioni della nostra applicazione. Al posto della confi- 
gurazione JDBC era possibile definire un datasource attraverso DBCP (Jakar- 
ta Commons Database Connection Pool) o tramite JNDI nel caso in cui 
magari vogliamo utilizzare un datasource definito in un container come 
un Application Server. Alla fine del file di configurazione abbiamo inse- 
rito un tag sqlMap: 

<sqlMap resource= " it/ioprogrammo/librodb/ibatis/Utente.xml " /> 

che definisce una delle risorse che utilizzeremo nel nostro programma. 
Questo file XML indicato è un file di mapping, però in questo caso, a dif- 
ferenza di Hibernate, mappa una serie di statement SQL con un deter- 
minato metodo che può venire richiamato. Il significato di questo map- 
ping è simile a quello di Hibernate, ma ci troviamo sostanzialmente in 
una situazione differente. Infatti, mentre un tool di ORM come Hiberna- 
te cerca di creare un'associazione stretta tra classe e tabella, attraver- 
so iBatis questa associazione la possiamo creare noi a livello di SQL. 
Per ogni operazione che possiamo richiamare dal nostro programma, ci 
è consentito associare una classe che mappa i risultati, ma a livello di 
SQL definiamo in dettaglio cosa deve essere fatto. Per capire meglio 
questo meccanismo vediamo prima di tutto la definizione della tabel- 
la che utilizzeremo in questo esempio: 

CREATE TABLE 'libro' .'utente' ( 
'ID' INTEGER UNSIGNED NOT NULLAUTOJNCREMENT, 
'NOME' VARCHAR(45) NOT NULL, 
'COGNOME' VARCHAR(45) NOT NULL, 
'USERNAME' VARCHAR(45) NOT NULL, 
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'PASSWORD' VARCHAR(45) NOT NULL, 
'EMAIL' VARCHAR(45) NOT NULL, 
'VERIFIED' BOOLEAN NOT NULL, 



) 

ENGINE = lnnoDB; 

Di seguito riportiamo il file Utente.xml, in cui abbiamo definito una se- 
rie di operazioni attraverso le quali possiamo effettuare le quattro clas- 
siche operazioni di inserimento: lettura, modifica e cancellazione. 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" 

"http://www.ibatis.com/dtd/sql-map-2.dtd"> 

<sqlMap namespace=" Utente "> 

<select id="getUtente" 

resultClass="it.ioprogrammo.librodb.ibatis.Utente"> 

SELECT ID as id, 

NOME as nome, 

COGNOME as cognome, 

USERNAME as username, 

PASSWORD as password, 

EMAIL as email, 

VERIFIED as verified 

FROM UTENTE 

WHERE ID = #value# 
</select> 

<insert id="insertUtente" 



parameterClass="it.ioprogrammo.librodb.ibatis.Utente"> 
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UTENTE (NOME, COGNOME.USERNAME, PASSWORD, EMAIL, 

VERIFIED) 

VALUES (#nome#, #cognome#, #username#, #password#, 

#email#, #verified#) 

<selectKey 

keyProperty="id" 

resultClass="int"> 

SELECT LAST_INSERT_ID() AS value 
</selectKey> 
</insert> 

<update id="updateUtente" 

parameterClass="it.ioprogrammo.librodb.ibatis. Utente "> 
UPDATE UTENTE 
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SET NOME = #nome#, 
COGNOME = #cognome#, 
USERNAME = #username#, 
PASSWORD = #password#, 
EMAIL = #email#, 
VERIFIED = #verified# 



WHERE ID = #id# 
</update> 

<delete id="deleteUtente" 

parameterClass="it.ioprogrammo.librodb.ibatis.Utente"> 

DELETE UTENTE 

WHERE ID = #id# 
</delete> 

</sqlMap> 

All'interno di questo file vediamo quattro diversi tag che definiscono 
delle operazioni collegate alla classe Utente. Quest'ultima è il classico 
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JavaBean che gestisce tutte le informazioni che ci interessano: 
package it.ioprogrammo.librodb.ibatis; 



public class Utente { 
String nome; 
String cognome; 
String username; 
String password; 
String email; 
int id; 

boolean verified; 



Le operazioni che sono definite nel file di mapping vengono prima di tut- 
to suddivise per tipologia (insert/update/select/delete). Ad ogni opera- 
zione viene dato un id, che sarà richiamato lato Java fornendo come 
parametro il JavaBean definito nell'attributo parameterClass. In que- 
sto modo i comandi SQL vengono generati a runtime, prendendo i va- 
ri parametri che vengono passati al motore di iBatis e costruendo dina- 
micamente le stringhe. All'interno dei vari metodi è possibile distingue- 
re i parametri, che vengono definiti come di seguito: 



USERNAME = #username# 



iBatis, durante l'esecuzione, prenderà questi parametri dall'oggetto che 
gli viene fornito insieme alla chiamata. Chiaramente, il fatto che ci sia- 
no queste quattro tipologie di operazioni, con la possibile definizione di 
un identificativo, ci lascia aperta la possibilità di inserire diverse opera- 
zioni per una stessa tipologia. Ad esempio nel nostro programma po- 
tremmo aver bisogno di due diverse operazioni di delete, che possiamo 
semplicemente definire nel seguente modo con due diversi id 
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<delete id= " deleteUtenteByld " 

parameterClass=" it.ioprogrammo.librodb.ibatis.Utente"> 

DELETE UTENTE 

WHERE ID = #id# 
</delete> 

<delete id= " deleteUtenteByCredentials " 

parameterClass=" it.ioprogrammo.librodb.ibatis.Utente"> 
DELETE UTENTE 

WHERE USERNAME = #username# 
AND PASSWORD = #password# 
</delete> 

C'è una cosa da approfondire per quanto riguarda l'operazione di insert, 
infatti, rispetto alle altre è presente un altro tag, selectKey 

<selectKey 

keyProperty=" id " 

resultClass="int"> 

SELECT LAST_INSERT_ID() AS value 
</selectKey> 

Questo tag serve a valorizzare l'id della classe Utente. L'id, in questo ca- 
so, è stato definito con una colonna autoincrement di MySQL, in altri ca- 
si con Oracle e PostgreSQL potremmo definirli con una sequence, ma chia- 
ramente non la definiremmo noi dal punto di vista del codice. 
Proprio per questo nel momento in cui viene inserita la nuova entry nel- 
la tabella abbiamo comunque un oggetto Utente, nel quale non ab- 
biamo valorizzato l'id. Attraverso questo tag riusciamo a valorizzare 
questa informazione, recuperandola dal database. In questo caso vie- 
ne richiesto, attraverso un comando SQL specifico di MySQL, l'ultimo 
id inserito e valorizziamo la proprietà id dell'Utente con questo valore. 
Così facendo abbiamo dal punto di vista del codice un oggetto Utente 
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appena inserito, con il campo id valorizzato, senza dover procedere ad 
una successiva select per sapere quale sia questo valore (i programma- 
tori che utilizzano JDBC sanno bene a cosa mi riferisco). 

ESECUZIONE 

Analizziamo ora come richiamare la configurazione che abbiamo scrit- 
to nel precedente paragrafo all'interno di un nostro programma. All'ini- 
zio dobbiamo richiamare la configurazione attraverso le classi della li- 
breria di iBatis e poi vedremo come poter eseguire uno dei diversi coman- 
di presenti: 

package it.ioprogrammo.librodb.ibatis; 

import java.io.lOException; 
import java.io.Reader; 
import java.sql.SQLException; 

import com.ibatis.common.resources.Resources; 
import com.ibatis.sqlmap.client.SqlMapCIient; 
import com.ibatis.sqlmap.client.SqlMapCIientBuilder; 



public class Insert { 

public static void main(String[] args) { 
String resource = 

" it/ioprogrammo/librodb/ibatis/iBatis5qlMapConfig.xml"; 
Reader reader=null; 
try{ 

reader = Resources.getResourceAsReader (resource); 
} catch (lOException e) { 



e.printStackTraceQ; 
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} 

SqlMapCIient sqlMap = 

SqlMapClientBuilder.buildSqlMapClient(reader); 
Utente utente=new Utente(); 
utente.setNome(" Federico"); 
utente.setCognome(" Paparoni "); 
utente.setUsername("doc"); 
utente.setEmail("doc@javastaff.com"); 
utente.setPassword("NONLASO"); 
utente.setVerified(true); 
try { 

sqlMap.insert( " insertUtente " .utente); 
} catch (SQLException e) { 
e.printStackTrace(); 
5ystem.exit(-1); 

} 

System. out.println("#ID "+utente.getld()); 

} 
} 

i 

Come prima operazione forniamo la nostra configurazione, memorizza- 
ta nel file ÌBatisSqlMapConfig.xml, a iBatis. Questo lo facciamo trami- 
te un classico java.io.Reader, che viene richiamato per creare un ogget- 
to SqlMapCIient. Quest'ultimo verrà utilizzato per comunicare con il 
framework e avviare le operazioni desiderate. In seguito non facciamo 
altro che creare un oggetto Utente, valorizzare tutti i suoi campi (tran- 
ne id che verrà scelto in automatico dal db) e richiamare attraverso Sql- 
MapCIient l'operazione di insert classica. Subito dopo la insert avremo 
in output l'id dell'oggetto che abbiamo inserito, valore che viene recu- 
perato dal database e settato nell'oggetto che passiamo come argo- 
mento. L'operazione di insert che noi abbiamo utilizzato aveva un id 
uguale a "insertUtente" , quindi abbiamo passato questa stringa co- 
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me valore a SqlMapCIient. Come abbiamo detto in precedenza pos- 
siamo inserire diverse operazioni della stessa tipologia, differenziando- 
le proprio con l'id. Nell'attuale configurazione abbiamo inserito una se- 
lect che prende un solo utente, ma potremmo essere interessati a cari- 
care tutti gli utenti con una select differente. Per fare ciò non dobbiamo 
far altro che inserire questa nuova select, utilizzando chiaramente un 
id differente da quello già in uso: 

<select id="getUtenti" 

resultClass=" it.ioprogrammo.librodb.ibatis. Utente "> 

SELECT * 
FROM UTENTE 
</select> 

Ora che abbiamo aggiunto questa operazione al nostro file di configu- 
razione, possiamo vedere come richiamare l'operazione di select, visua- 
lizzando in seguito i risultati: 

package it.ioprogrammo.librodb.ibatis; 

import java.io.lOException; 
import iava.io.Reader; 
import java.sql.SQLException; 
import java. uti I .Array List; 
import java. util.lterator; 

import com.ibatis.common.resources.Resources; 
import com.ibatis.sqlmap.client.SqlMapCIient; 
import com.ibatis.sqlmap.client.SqlMapCIientBuilder; 

public class Select { 
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String resource = 

" it/ioprogrammo/librodb/ibatis/iBatisSqlMapConfig.xml"; 
Reader reader=null; 
try{ 

reader = Resources.getResourceAsReader (resource); 
} catch (lOException e) { 
e.printStackTrace(); 
System. exit(-1); 

} 

SqlMapCIient sqlMap = 

SqlMapClientBuilder.buildSqlMapClient(reader); 
ArrayList lista=null; 
try{ 

lista = (ArrayList)sql Map.queryForList( "getUtenti " ); 
} catch (SQLException e) { 
e.printStackTrace(); 
System. exit(-1); 

Iterator iterator=lista.iterator(); 
Utente utente; 
while(iterator.hasNext()) { 

utente=(Utente)iterator.next(); 

System. out.println(utente.getNome()+" 

" +utente.getCognome()); 

} 

System. out.println(lista.sizeQ); 



In questo caso la nostra operazione di select viene richiamata utilizzan- 
do il metodo queryForList. Il risultato della select, che dovrebbe essere 
una serie di oggetti Utente rappresentanti le entry del database, vengo- 
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no restituite all'interno di un oggetto List. Attraverso questo meccani- 
smo di mapping, abbiamo all'interno del nostro oggetto ArrayList tut- 
ti gli utenti, che andiamo a visualizzare con un semplice Iterator. 
Questo è uno dei diversi modi in cui possiamo mappare le informazio- 
ni che ci vengono restituite dal database. iBatis, per quanto riguarda il 
mapping, è estremamente flessibile, proprio perché essendo una solu- 
zione ibrida tra l'ORM puro e l'SQL cerca di unire nel migliore dei modi 
le esigenze dal punto di vista della programmazione con quelle relati- 
ve al mondo dei database. 

SQL MAP 

Il punto centrale di iBatis viene chiamato SQL Map non a caso. Infatti, 
come abbiamo già visto, viene proprio creato un mapping attraverso 
l'SQL definito per ogni operazione. Nell'esempio precedente abbiamo vi- 
sto uno dei casi più semplici in cui ci possiamo trovare, una classe nel do- 
minio della nostra applicazione che corrisponde ad una precisa tabella 
nel database. Ora vedremo un esempio più complesso, in cui iBatis riu- 
scirà a risolvere il problema con una semplice configurazione. Immagi- 
niamo di avere un database già definito, magari che noi possiamo sol- 
tanto utilizzare, in cui sono presenti due tabelle che interessano alla no- 
stra applicazione. Per creare queste due tabelle possiamo avviare i se- 
guenti script: 

CREATE TABLE 'libro' ."tabellaA" ( 
'ID' INTEGER UNSIGNED NOT NULL AUTOJNCREMENT, 
'INFO' VARCHAR(45) NOT NULL, 
'ALTRAINFO' VARCHAR(45) NOT NULL, 
PRIMARY KEY ('ID') 

) 

ENGINE = InnoDB; 
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'ID' INTEGER UNSIGNED NOT NULLAUTOJNCREMENT, 
'INFO' VARCHAR(45) NOT NULL, 
'ALTRAINFO' VARCHAR(45) NOT NULL, 
'ID_TABELLA_A INTEGER UNSIGNED NOT NULL, 
PRIMARY KEY OD'), 

CONSTRAINT "FK_tabeIlaB_T FOREIGN KEY'FKLtabellaBJ' 

flDJABELLA_A') 

REFERENCES 'tabellaa' f ID") 
ON DELETE CASCADE 
ON UPDATE CASCADE 

ENGINE = InnoDB; 

Dal punto di vista della nostra applicazione abbiamo una sola informa- 
zione da gestire poiché, per quanto riguarda la logica del nostro program- 
ma, le due tabelle sono gestite come una sola entità. In questo caso 
l'entità che utilizzeremo nel nostro programma è una semplice classe con 
alcuni valori: 

package it.ioprogrammo.librodb.ibatis; 

( ~J 

public class Informazione { 
int id; 
String info; 
String info2; 
String info3; 



public int getld() { 
return id; 

} 

public void setld(int id) { 
this.id = id; 

} 



I libri di ioPROGRAMMo/Java e Database 



103 



JAVA 
E DATABASE 



IBATIS 



Capitolo 3 



public String getlnfof) { 
return info; 



this.info = info; 

} 

public String getlnfo2(J { 
return info2; 

} 

public void setlnfo2(String info2) { 
this.info2 = info2; 

} 

public String getlnfo3() { 
return info3; 

} 

public void setlnfo3(String info3) { 
this. info3 = info3; 



Con il mapping che abbiamo visto ci sarebbero dei problemi, perché 
non viene subito in mente il modo in cui gestire questa situazione. 
iBatis ci permette di definire una certa classe per restituire le informa- 
zioni ed oltre a questo possiamo anche decidere all'interno di questa clas- 
se quali valori ritornati dalla query devono essere settati. Insomma riu- 
sciamo a definire un mapping riga per riga, inviando al database un co- 
mando SQL che ci permette di definire una join tra le due tabelle ed ela- 
borando il risultato, incapsulandolo in quello che ci fa più comodo. 
Il file di mapping dove viene definito l'operazione che abbiamo descrit- 
to viene riportato qui di seguito: 



<?xml version="1 .0" encoding="UTF-8" ?> 
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" http://www.ibatis.com/dtd/sql-map-2.dtd"> 
<sqlMap namespace="lnformazione"> 

<resultMap id=" informazione" 

class="it.ioprogrammo.librodb.ibatis.lnformazione"> 
<result property="id" column="A.ID"/> 
<result property="info" column="A.INFO"/> 
<result property="info2" column="B.INFO" /> 
<result property="info3" column="B.ALTRAINFO" /> 

</resultMap> 

<select id="getlnformazione" parameterClass="int" 

resu ltMap= " informazione " > 

SELECT A.ID, A.INFO, 
B.INFO, B.ALTRAINFO 
FROM tabellaAA, tabellaB B 
WHERE A.ID=B.ID_TABELLA_A 
AND A.ID = #value# 
</select> 
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</sqlMap> 

Come potete vedere nell'operazione di select abbiamo fatto una join 
tra le due tabelle che ci interessano, selezionando le informazioni che do- 
vremo gestire nella nostra applicazione. Abbiamo inoltre definito un re- 
sultMap, invece del resuItClass che avevamo utilizzato precedente- 
mente. Attraverso questo tag indichiamo a iBatis che i risultati della se- 
lect dovranno essere mappati in un certo modo, definito nel tag result- 
Map che ha un id uguale a "informazione". Abbiamo optato per inse- 
rire le informazioni nella classe it.ioprogrammoJibrodb.ibatis.Informazione, 
settando tutte le varie proprietà di questa classe con le varie colonne che 
vengono restituite dalla nostra select. Per testare questo mapping non 
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dobbiamo far altro che richiamare questa funzione, passando come pa- 
rametro un id e aspettando un risultato della classe Informazione: 

package it.ioprogrammo.librodb.ibatis; 

import java. io.Reader; 

import com.ibatis.common.resources.Resources; 
import com.ibatis.sqlmap.client.SqlMapCIient; 
import com.ibatis.sqlmap.client.SqlMapCIientBuilder; 

public class TestResultMap { 

public static void main(String[] args) throws Exception { 
String resource = 

"it/ioprogrammo/librodb/ibatis/iBatis5qlMapConfig.xml"; 
Reader reader= Resources.getResourceAsReader (resource); 
SqlMapCIient sqlMap = 

SqlMapClientBuilder.buildSqlMapClient(reader); 

Informazione 

informazione=(lnformazione)sqlMap.queryForObject("getlnformazione",1) 

; 

System. out.println(informazione.getld()); 
System. out.println(informazione.getlnfo()); 
System. out.println(informazione.getlnfo2()); 
System. out.println(informazione.getlnfo3()); 

} 

} 

Il metodo non è l'unico che iBatis fornisce. Ad esempio, potremmo in- 
serire le informazioni restituite dalla select all'interno di un oggetto Ha- 
shmap, dove i nomi delle colonne sarebbero gli id. Oltre a questo pos- 
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siamo utilizzare queste "mappe" anche in ingresso, ovvero definire un 
oggetto che viene passato come parametro e grazie al quale possiamo 
generare un comando SQL: 

<insert id="insertQualcosa" 

parameterClass="it.ioprogrammo.librodb.ibatis.Qualcosa "> 

insert intoTESTTABLE(ID, INFOI, INF02) 

values (#id#,#info1#,#info2#) 
</insert> 

L'oggetto che passiamo come parametro avrà diverse proprietà che ven- 
gono recuperate da iBatis e che ci permettono di generare il comando 
SQL di nostro interesse. Seguendo questa tecnica è possibile definire 
mapping multipli e altre finezze che permettono di lavorare solo sulla con- 
figurazione, senza dover introdurre classi non pertinenti con la nostra ap- 
plicazione. 



quattro differenti tipologie: 

• MEMORY: I risultati vengono salvati in memoria 

• FIFO: Anche questa tipologia prevede il salvataggio in memoria, 
adottando inoltre la tecnica FIFO (First In First Out), ovvero vengo- 
no rimossi dalla cache gli oggetti più vecchi 

• LRU: Si basa sempre sulla memoria e utilizza la tecnica LRU (Least 
Recently Used), che elimina gli oggetti meno utilizzati 

• OSCACHE: Questa è un progetto opensource che è possibile utiliz- 
zare come cache provider per la nostra applicazione iBatis 

Ogni diversa tecnica che adottiamo ha dei particolari valori che possia- 
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mo settare. MEMORY, ad esempio, può avere una configurazione ad- 
dizionale che riguarda il modo in cui la JVM deve gestire gli oggetti: 

• STRONG: In questo modo gli oggetti vengono eliminati dalla ca- 
che solo quando scade un certo timeout che impostiamo a livello di 
configurazione 

• SOFT: Questo valore per la cache MEMORY cerca di tenere gli og- 
getti in memoria, fino a quando si raggiungono certi limiti che ri- 
chiedono di liberare un po' di memoria 

• WEAK: L'approccio più lasco, che sicuramente non va a riempire la 
memoria ma che richiede più comandi SQL da richiamare ogni tan- 
to 

Le informazioni vengono mantenute in cache nel rispetto della tipolo- 
gia che noi andiamo a definire. Oltre a questo c'è da dire che ci sono dei 
"trigger" che permettono di capire quando bisogna svuotare la cache. 
Questi vengono definiti attraverso i seguenti tag : 

• flushlnterval Viene definito l'intervallo di tempo dopo il quale gli 
oggetti in cache possono essere svuotati 

• flushOnExecute: Quando abbiamo dei dati che vogliamo tenere in 
cache, questi potrebbero essere invalidati da altre operazioni. Ad 
esempio se abbiamo in cache i risultati di una select, le altre opera- 
zioni potrebbero invalidare questi dati quindi è necessario invalida- 
re la cache quando vengono eseguiti certi comandi e questo tag ser- 
ve proprio per definire le diverse operazioni che devono azionare 
questo meccanismo 

Ora che abbiamo visto le diverse configurazioni che possono essere uti- 
lizzate, è arrivato il momento di vedere un esempio funzionante con la 
cache abilitata. La cosa principale che dobbiamo fare è quella di deci- 
dere quale tipologia di cache utilizzare e come configurarla. In questo 
esempio andremo a inserire nel mapping Utente.xml una cache per 
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l'operazione che seleziona tutti gli utenti: 

<cacheModel id="cacheSelectUtenti" type=" MEMORY" > 
<flushOnExecute statement="insertlltente7> 
<flushOnExecute statement= " updateUtente "/> 
<flushOnExecute statement= " deleteUtente "/> 
<property name="reference-type" value="WEAK7> 

</cacheModel> 

<select id=" getUtenti" 

resultClass="it.ioprogrammo.librodb.ibatis.Utente" 
cacheModel= " cacheSelectUtenti " 

> 

SELECT * 
FROM UTENTE 

</select> 



s 



Nell'operazione getUtenti abbiamo segnalato che utilizzeremo una ca- 
che di nome cacheSelectUtenti. La definizione di quest'ultima eviden- 
zia il tipo, MEMORY, le tre diverse operazioni che la invalideranno e il 
modo in cui utilizzeremo i riferimenti agli oggetti, WEAK. Ora per te- 
stare il funzionamento di questa cache vedremo un programma che pri- 
ma avvia l'operazione getUtenti, poi l'avvia una seconda volta dopo un 
piccolo sleep del Thread. Successivamente inseriremo un nuovo uten- 
te, richiamando quindi l'operazione insertUtente ed infine verranno ri- 
caricati un'altra volta tutti gli utenti: 

package it.ioprogrammo.librodb.ibatis; 

import java.io.Reader; 
import java . uti I. Array List; 



import com.ibatis.common.resources.Resources; 
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import corri. ibatis.sqlmap.client.SqlMapCIient; 
import com.ibatis.sqlmap.client.SqlMapCIientBuilder; 

public class SelectCache { 

public static void main(String[] args) throws Exception { 
String resource = 

"it/ioprogrammo/librodb/ibatis/iBatisSqlMapConfig.xml"; 
Reader reader= Resources.getResourceAsReader (resource); 
SqlMapCIient sqlMap = 

SqlMapClientBuilder.buildSqlMapClient(reader); 

long start; 
long end; 

System. out.printlnf Prima select"); 
start=System.currentTimeMillis(); 

ArrayList lista = (ArrayList)sqlMap.queryForList("getUtenti"); 

end=System.currentTimeMillis(); 

System. out.println("Tempo impiegato: "+(end-start)); 

Thread.currentThread().sleep(1000); 

System.out.println r Selectdopolosleep"); 

start=System.currentTimeMillis(); 

lista = (ArrayList)sqlMap.queryForList("getUtenti"); 

end=System.currentTimeMillis(); 

System. out.println("Tempo impiegato: "+(end-start)); 

Utente utente=new Utente(); 
utente.setNome(" Federico"); 



utente.setCognome("Paparoni"); 
utente.setUsernamefdoc"); 
utente.setEmail("doc@javasta ff.com"); 




I IO 
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utente.setVerified(true); 
sqlMap.insert("insertUtente", utente); 



System.out.printlnfSelect dopo insert"); 

start=System.currentTimeMillis(); 

lista = (ArrayList)sqlMap.queryForList("getUtenti"); 

end=System.currentTimeMillis(); 

System.out.println( " Tempo impiegato: " +(end-start)); 



} 



Una volta che viene avviato questo programma possiamo vedere l'output 
che ci farà capire bene cosa succede 

Prima select 
Tempo impiegato:440 
Select dopo lo sleep 
Tempo impiegatolo 
Select dopo insert 
Tempo impiegatolo 



s 



9 



Come da copione, la seconda select impiega un tempo infinitesimale 
per recuperare le informazioni, visto che queste sono già in memoria. 
Però dopo l'operazione di insert la cache viene svuotata e quindi viene 
impiegato comunque del tempo per restituire i valori corretti. 



DYNAMIC SQL 

Il fatto di avere i comandi SQL direttamente nel file di mapping porta si- 
curamente dei vantaggi nella costruzione della nostra applicazione. 
Dobbiamo però pensare anche al fatto che in alcune situazioni non sap- 
piamo a priori il preciso comando che dovremo comunicare al databa- 
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se, perché magari vogliamo realizzare una sorta di dinamicità all'inter- 
no del nostro codice. Anche in questo iBatis ci viene in aiuto, permetten- 
doci di definire all'interno delle operazioni una sorta di SQL dinamico, 
che viene costruito a runtime in base a determinate situazioni. 

<select id="getUtentiDynamic" 

parameterClass="it.ioprogrammo.librodb.ibatis.RicercaUtente" 
resultClass="it.ioprogrammo.librodb.ibatis.Utente" 

> 

SELECT * 
FROM UTENTE 

<dynamic prepend="WHERE "> 

<isNull property="email" removeFirstPrepend="true" 
prepend="AND"> 
EMAIL 15 NULL 
</isNull> 

<isNotNull property=" email" prepend="AND"> 

EMAIL = #email# 
</isNotNull> 

<isNull property=" password" prepend="AND"> 
PASSWORD IS NULL 



<isNotNull property=" password" prepend="AND"> 

PASSWORD = #password# 
</isNotNull> 
</dynamic> 
</select> 

La select che abbiamo riportato utilizza il meccanismo appena detto. 
Praticamente, nella ricerca degli utenti noi vogliamo dinamicamente 
cambiare la query in base ad un parametro che passiamo ad iBatis. 
Questo parametro è una semplice classe che in questo caso contiene due 
possibili parametri sui quali vogliamo costruire la nostra query dinami- 
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ca (anche se non ha molto senso dal punto di vista logico, utilizziamo que- 
sta classe e questa operazione solo per far capire il tema trattato basan- 
doci su quello che abbiamo realizzato fino ad ora) 

package it.ioprogrammo.librodb.ibatis; 

public class RicercaUtente { 
String email; 
String password; 

public String getEmail() { 
return email; 

} 

public void setEmail(String email) { 
this.email = email; 

} 

public String getPassword() { 
return password; 

} 

public void setPassword(String password) { 
this.password = password; 

} 

} 

iBatis, quindi, opera dinamicamente all'interno del tag dynamic, dove ve- 
diamo vengono esaminati i due valori delle proprietà di RicercaUtente 
e in base al loro valore (nullo o non in questo caso) viene appesa alla no- 
stra query una certa stringa. I tag che possono essere utilizzati all'in- 
terno di dynamic, per esaminare una certa espressione e quindi deci- 
dere se scrivere l'SQL corrispondente, sono riportati di seguito 

• isEmpty: Verifica se una variabile è vuota 

• isNotEmpty: Verifica se una variabile non è vuota 
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• isNull: Verifica se una variabile è nulla 

• isNotNull: Verifica se una variabile non è nulla 

• isPropertyAvailable: A runtime viene controllata la presenza di 
un parametro 

• isNotPropertyAvailable: A runtime viene controllata l'assenza di 
un parametro 

• isEqual: Controlla l'uguaglianza 

• isNotEqual: Controlla che non ci sia uguaglianza 

• isGreaterThan: Verifica se una variabile è più grande di una certa 
proprietà o di un certo valore 

• isGreaterEqual: Uguale alla precedente, in più viene inclusa 
l'uguaglianza 

• isLessThan: Verifica se una variabile è più piccola di una certa pro- 
prietà o di un certo valore 

• isLessEqual Uguale alla precedente, in più viene inclusa l'uguaglianza 

Ogni tag poi avrà bisogno di una serie di parametri aggiuntivi che per- 
mettono ad iBatis di applicare quella determinata regola. Per esempi e 
approfondimenti sul tema vi rimando alla documentazione ufficiale di 
iBatis. Per concludere c'è solo da notare che quando vengono utilizza- 
te una serie di queste regole, che magari vanno in AND o in OR, di so- 
lito c'è il bug con la classica programmazione JDBC che porta a costrui- 
re una stringa di questo tipo: 

SELECT X,Y,Z FROM ABC WHERE AND X=5 AND Y=4; 

Praticamente viene messo l'AND (o l'OR) anche quando non ce ne sa- 
rebbe bisogno. Proprio per questo motivo è possibile levare questa con- 
dizione dalla stringa SQL e inserirla nella configurazione del tag: 

<isNull property="email" removeFirstPrepend="true" 



prepend="AND"> 
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</isNull> 

In questo tag abbiamo deciso che l'SQL andrà in AND con altre espres- 
sioni, utilizzando l'attributo prepend. Oltre a questo abbiamo indicato 
a iBatis di rimuovere il primo operatore logico, proprio per evitare di 
scrivere una comando SQL sbagliato. Chi ha visto codice JDBC (non ot- 
timizato) che appunto costruiva dinamicamente query utilizzando ope- 
ratori AND e OR sicuramente capirà quanto sia utile questo ulteriore 
meccanismo di iBatis. 



ABATOR 

Abator è un tool che ci permette di velocizzare il nostro lavoro utiliz- 
zando iBatis. Con questo strumento possiamo fare quanto segue: 

• Generare automaticamente classi Java che aderiscono alla struttu- 
ra delle nostre tabelle 

• Generare automaticamente anche i file di mapping per iBatis, all'in- 
terno dei quali sono già definite alcune operazioni standard 

• Creare uno strato DAO per la gestione degli oggetti Java generati 

Abator è sicuramente un buon tool per iniziare a programmare con iBa- 
tis, anche perché l'unica cosa che dobbiamo fornire a questo tool è una 
configurazione, dove gli indichiamo come collegarsi al nostro database 
e cosa generare nel dettaglio 

<?xml version="1 .0" encoding="UTF-8"?> 
<!DOCTYPE abatorConfiguration 

PUBLIC "-//Apache Software Foundation//DTD Abator for iBATIS 

Configuration 1.0//EN" 

" http://ibatis.apache.org/dtd/abator-config_1 _0.dtd " > 

<abatorConfiguration> 
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obatorContext id="LibroExample" generatorSet="Java2"> 
<jdbcConnection driverClass="com.mysql.jdbc.Driver" 
connectionURL= " jdbc:mysql://1 27.0.0.1 /libro " 
userld="root" 
password=" mysql"> 
<classPathEntry location="c:/lib/mysql-connector-java-5.0.4-bin.jar" /> 
</jdbcConnection> 

<javaTypeResolver > 

<property name="forceBigDecimals" value="false" /> 
</javaTypeResolver> 

<javaModelGenerator targetPackage="test.model" 

targetProject= " testsrc " > 

<property name="enableSubPackages" value="true" /> 

<property name="trimStrings" value="true" /> 
</javaModelGenerator> 

<sqlMapGenerator targetPackage= " test.xml " targetProject= "testsrc " > 

<property name="enableSubPackages" value="true" /> 
</sqlMapGenerator> 



<daoGenerator type= " IBATIS" 

targetPackage="it.ioprogrammo.librodb.ibatis.abator" 
targetProject= " testsrc " > 
<property name="enableSubPackages" value="true" /> 
</daoGenerator> 

<table schema=" LIBRO" tableName="UTENTE" 

domainObjectName= " Utente " > 



<property name="useActualColumnNames" value="true"/> 
</table> 
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</abatorConfiguration> 

Dopo aver scritto questo file possiamo generare le classi, i file di confi- 
gurazione e lo strato DAO richiamando Abator da linea di comando: 

java -jar abator.jar abatorConfig.xml true 

e avremo come risultato tutto quello che volevamo automaticamente. 
Per maggiori informazioni potete consultare l'uri 
http://ibatis.apache.org/abator.html 
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Il classico database con il quale abbiamo avuto a che fare fino- 
ra fa parte della categoria dei DBMS (Database Management Sy- 
stem) relazionali, ovvero dove i nostri dati vengono strutturati at- 
traverso degli schema, tabelle, righe e quant'altro. Questo non 
è l'unico modo in cui può essere implementato un database, in- 
fatti quello relazionale è uno dei modelli che ha avuto più suc- 
cesso tra le diverse tipologie e per questo motivo la stragrande 
maggioranza dei database utilizzati sono stati sviluppati secon- 
do questo paradigma. Tuttavia, quello che viene naturale dal 
punto di vista dello sviluppatore è cercare di mappare, nella ma- 
niera più indolore, lo strato informativo della propria applica- 
zione nei database relazionali. Abbiamo visto che questo viene 
fatto attraverso dei tool come Hibernate e iBatis che ci permet- 
tono di astrarre la nostra applicazione dal database e continua- 
re a ragionare in un'ottica Object Oriented. Bisogna comunque 
dire che esistono anche dei database che supportano nativa- 
mente il paradigma 00 e che per questo motivo vengono chia- 
mati ODBMS (Object DBMS). Attualmente, nell'ambito dei pro- 
getti opensource si possono segnalare i seguenti: 



• db4o - http://www.db4o.com 

• Perst - https://perst.dev.java.net 



Esistono molte altre realtà opensource ma non sono aggiorna- 
te come questi due progetti che meritano davvero un po' di at- 
tenzione. In questo capitolo ci occuperemo di db4o, un databa- 
se ad oggetti che è disponibile sia nella versione Java che .NET. 
Questo database, sviluppato dalla db4object Inc., è gratuita- 
mente utilizzabile con licenza GPL o sotto la dOCL (db4o Open- 
source CompatibilityLicense). Per essere utilizzato in ambito com- 
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merciale richiede una licenza. Guardando le prestazioni che so- 
no state estrapolate da PolePosition (un benchmark di vari data- 
base disponibile su http://www.polepos.org), si vede subito come 
db4o abbiamo delle prestazioni davvero interessanti. 
Per il dettaglio di tutte le sue funzionalità vi rimando al sito, do- 
ve è possibile trovare molta documentazione a riguardo. 

PRIMO CONTATTO 

Iniziamo a vedere come è possibile utilizzare db4o da Java. 
Prima di tutto dobbiamo scaricare la versione Java ed include- 
re nel nostro classpath i jar che troviamo all'interno della cartel- 
la lìb. Per quanto riguarda le differenti versioni di java sono pre- 
senti 3 diversi jar: 

• db4o-VERSIONE-java1.1.jar: Supporta Java 1 .1, quindi è uti- 
lizzabile anche nei device mobili che supportano quelle API 
Java 

• db4o-VERSIONE-java1.2.jar: Questa è la versione che può 
essere utilizzata se abbiamo a che fare con versioni di Java che 
vanno dalle 1.2 alle 1.4 

• db4o-VERSIONE-java5.jar: Per Java 5 

Immaginiamo ora di avere una nostra applicazione in Java che 
gestisce i giocatori di calcio. La classe con quale possiamo de- 
finire il giocatore potrebbe essere la seguente: 

package it.ioprogrammo.librodb.db4o; 

public class Giocatore { 



private String nome; 
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private Ruolo ruolo; 

private int età; 

private doublé ingaggio; 

public String getNome() { 
return nome; 

} 



public void setNome(String nome) { 
this.nome = nome; 

} 

public String getCognome() { 
return cognome; 

} s 



public void setCognome(String cognome) { 
this.cognome = cognome; 

public int getEta() { 
return età; 

} 



public void setEta(int età) { 
this.eta = età; 

} 



public doublé getlngaggio() { 
return ingaggio; 

} 



public void setlngaggio(double ingaggio) { 
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this.ingaggio = ingaggio; 

} 



return ruolo; 

} 

public void setRuolo(Ruolo ruolo) { 
this.ruolo = ruolo; 

} 

OOverride 

public String toStringO { 

return nome+" "+cognome+" : "+ruolo.name(); 

} 

> 

Giocatore è un classico oggetto Java, con diversi campi e i rela- 
tivi metodi get/set. Oltre a questo abbiamo ridefinito il metodo 
toStringO e abbiamo utilizzato un enumeration Ruolo che ci per- 
mette di definire il diverso ruolo che ha il giocatore: 

package it.ioprogrammo.librodb.db4o; 

public enum Ruolo { 
ATTACCANTE("attaccante"), 
CENTROCAMPISTA("centrocampista"), 
DIFENSORE("difensore"), 
PORTIERE(" portiere"); 



private String ruolo; 
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this.ruolo= ruolo; 



Vogliamo ora vedere come memorizzare e successivamente re- 
cuperare delle istanze della classe Giocatore con db4o. 
Per fare questo possiamo accedere a db4o in locale, puntando 
direttamente al file che rappresenta il database oppure connet- 
tendosi da remoto a un server db4o. Per accedere in maniera 
locale non dobbiamo far altro che richiamare un determinato 
file e utilizzare le API di db4o per salvare l'oggetto: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 

import com.db4o.0bjectContainer; 

public class TestLocalDb { 

public static void main(String a[]) { 
Giocatore giocatore=null; 
ObjectContainer db=Db4o.openFile("db4o.db"); 
try{ 

giocatore=new Giocatore(); 

giocatore.setNomef Francesco"); 

giocatore.setCognome("Totti"); 

giocatore.setEta(29); 

giocatore.setlngaggio(20000); 

giocatore.setRuolo(Ruolo.ATTACCANTE); 

db.set(giocatore); 

db.commit(); 

} 

catch (Exception e) { 

System. out.println(e.toStringO); 
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} 

finally { 
db.closeQ; 



} 

} 

Attraverso il metodo statico openFile() della classe Db4o abbia- 
mo inizializzato l'oggetto ObjectContainer che ci permette di dia- 
logare con il database. Dopo di ciò non abbiamo fatto altro che 
settare tutti i campi del nostro oggetto Giocatore, salvarlo attra- 
verso il metodo set() ed effettuare la commit con il relativo me- 
todo commit(). Vediamo ora come leggere gli oggetti della clas- 
se Giocatore che abbiamo memorizzato: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 

import com.db4o.ObjectContainer; 

import com.db4o.0bjectSet; 

public class TestLocalDbReadf 
public static void main(String a[]) { 
Giocatore giocatore=new Giocatore(); 
ObjectContainer db=Db4o.openFile("db4o.db"); 
ObjectSet result=db.get(giocatore); 
System.out.println("Giocatori trovati: " +result.size()); 
while(result.hasNext()) { 

System.out.println(result.nextO); 

} 

db.closef); 

} 
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In questo caso ci siamo sempre collegati in locale sul file di db4o 
e abbiamo utilizzato il metodo get(), passando come argomen- 
to un oggetto Giocatore non valorizzato che ci permette di ave- 
re tutti gli oggetti della classe Giocatore che sono memorizzati 
nel database. In un paragrafo successivo vedremo come poter 
effettuare delle query utilizzando tre diversi metodologie che 
vengono offerte da db4o. Ora per completare questo "primo 
contatto" vedremo anche come collegarsi al nostro database 
attraverso la rete. L'approccio di collegarsi ad un database tra- 
mite filesystem chiaramente ha dei limiti, specialmente quan- 
do vogliamo offrire un servizio anche a processi remoti. Proprio 
per questo c'è la possibilità di gestire un vero e proprio server 
su db4o, settando le credenziali per l'accesso come in un tradi- 
zionale database. 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 
import com.db4o.0bjectContainer; 
import com.db4o.0bjectServer; 

public class TestServer { 

public static void main(String a[]) { 
String USERNAME="doc"; 
String PASSWORD="cod"; 
int PORTA=30330; 
boolean running=true; 

ObjectServer server=Db4o.openServer("db4o.db", PORTA); 
server.grantAccess(USERNAME,PASSWORD); 

try { 

while(running){ 
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Thread.currentThread().sleep(20000); 

} 

} catch (Exception e) { 



} 



Il metodo openServerQ di Db4o ci permette di avviare un server 
e di ottenere l'istanza di ObjectServer. In questo modo possia- 
mo abilitare le credenziali per l'accesso. Il database è sempre 
un file, ma in questo caso viene data la possibilità di collegarsi 
da remoto. Nell'esempio precedente facciamo ciclare all'infini- 
to il nostro programmino per lasciare il server in piedi, chiaramen- 
te è una soluzione abbastanza "artigianale" e quindi potrebbe 
essere gestita in una maniera migliore. Vediamo il codice del 
client che effettua il collegamento al database attraverso la re- 
te: 



package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 

import com.db4o.ObjectContainer; 

import com.db4o.0bjectSet; 

public class TestClient { 

public static void main(String a[]) { 
String USERNAME="doc"; 
String PASSWORD="cod"; 
int PORTA=30330; 
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client=Db4o.openClient("localhost",PORTA,USERNAME,PASSWORD); 
ObjectSet result=client.get(new GiocatoreO); 
System.out.println("Giocatori trovati: "+result.size()); 
while(result.hasNext()) { 

System. out.println(result.nextO); 

} 

client.closeQ; 



} 



} 



Per effettuare il collegamento abbiamo passato come argomen- 
to al metodo openClientQ di Db4o tutte le informazioni necessa- 
rie. Abbiamo quindi ottenuto un ObjectContainer, con il quale pos- 
siamo comportarci come quando ci colleghiamo in locale. 



s 



QUERY 

Passiamo ora a vedere i diversi metodi che possiamo utilizzare 
con db4o per effettuare delle ricerche. I tre possibili modi in cui 
possiamo effettuare delle query sul nostro database vengono 
riportati di seguito: 

• QBE (Query By Example) 

• Native query 

• SODA Query 

Le Query By Example, già analizzate nel precedente paragrafo, 
passano al metodo getQ di ObjectContainer un'istanza della clas- 
se che ci interessa. Il risultato sarà un ObjectSet, un'interfaccia 
presente nelle API di db4o che estende diverse interfacce delle 
API standard Java, come Collection, Iterable, Iterator e List. 
All'interno di questo oggetto troveremo il risultato della nostra 
query. Per poter selezionare solo alcune istanze all'interno del 
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nostro database, ad esempio quelle che hanno un particolare 
valore per una loro variabile, non dobbiamo far altro che valo- 
rizzare questa variabile all'interno dell'oggetto che passiamo a 
ObjectContainer. Qui di seguito trovate un esempio di utilizzo 
di QBE: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 

import com.db4o.ObjectContainer; 

import com.db4o.0bjectSet; 

public class QueryByExample { 
public static void main(String a[]) { 
Giocatore giocatore=new Giocatore(); 
ObjectContainer db=Db4o.openFile("db4o.db"); 
ObjectSet result=db.get(giocatore); 
System.out.println("Giocatori trovati: " +result.size()); 
while(result.hasNext()) { 

System.out.println(result.nextO); 



giocatore.setEta(29); 
result=db.get(giocatore); 

System.out.println("Giocatori di 29 anni trovati: "+result.size()); 
while(result.hasNext()) { 

System.out.println(result.nextO); 

} 

db.closeO; 

} 



Nella prima query vengono selezionate tutte le istanze di Gioca- 
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tare presenti nel nostro database. Con la seconda query, invece, 
avendo settato l'età del giocatore, riusciremo a recuperare tut- 
te le istanze di Giocatore che hanno l'attributo età settato a 29. 
Chiaramente questo metodo per la ricerca è veloce ma non per- 
mette di avere un controllo più approfondito delle ricerche che 
dobbiamo fare. La seconda tipologia di query che db4o offre so- 
no le Native Query. Con questo strumento possiamo effettuare 
delle query differenti da QBE, ottimizzate dove possibile da db4o. 
Attraverso il metodo queryO di ObjectContainer possiamo utiliz- 
zare questa metodologia. Ma vediamo ora cosa è possibile rea- 
lizzare: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 
import com.db4o.ObjectContainer; 
import com.db4o.ObjectSet; 
import com.db4o.query.Predicate; 
import java.util.lterator; 
import java. util. List; 

public class NativeQuery { 

public static void main(String a[]) { 

ObjectContainer db=Db4o.openFile("db4o.db"); 
System.out.println("Selezione con Inner Predicate"); 
List<Giocatore> giocatori = db.query(new Predicate<Giocatore>() { 
public boolean match(Giocatore giocatore) { 
return giocatore.getEta()==29; 

} 

}); 

lterator<Giocatore> iterator=giocatori.iterator(); 
while(iterator.hasNext()) { 

System.out.println(iterator.nextO); 
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} 

//SELEZIONE CON PREDICATO PREDEFINITO 
System.out.println("Selezione con Predicate predefinito"); 
giocatori = db.query(new RuoloPredicateO); 
iterator=giocatori.iterator(); 
while(iterator.hasNext()) { 

System.out.println(iterator.nextO); 

} 

//SELEZIONE CON PREDICATO E COMPARATOR PREDEFINITO 
System.out.println("Selezione con Predicate e Comparator 

predefiniti"); 

giocatori = db.query(new RuoloPredicate(),new 

CognomeComparatorO); 

iterator=giocatori.iterator(); 
while(iterator.hasNext()) { 

System.out.println(iterator.nextO); 

} 

db.closeO; 



La prima ricerca che effettuiamo è quella dove viene definito il 
Predicate attraverso una inner class. Predicate è una classe astrat- 
ta di db4o che noi possiamo utilizzare per definire quali tra gli 
oggetti di una determinata classe devono essere presi come ri- 
sultato della nostra query. Questo è possibile implementando il 
metodo match(), dove dobbiamo ritornare true se l'oggetto sod- 
disfa la nostra ricerca. La seconda ricerca che abbiamo effettua- 
to nel precedente codice utilizza un Predicate che abbiamo de- 
finito: 
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package it.ioprogrammo.librodb.db4o; 

import com.db4o.query.Predicate; 

public class RuoloPredicate extends Predicate<Giocatore>{ 

public boolean match(Giocatore giocatore) { 
String ruolo; 

ruolo=giocatore.getRuolo().toString(); 
if (ruolo.equals("ATTACCANTE")) 

return true; 
else 

return false; 

} 

} 



s 



RuoloPredicate praticamente viene utilizzato per scegliere sol- 
tanto le istanze di Giocatore con il ruolo di attaccante. Vediamo 
infine l'ultima query, dove oltre al nostro Predicate abbiamo uti- 
lizzato un CognomeComparator, classe che implementa Query- 
Comparatore serve per ordinare i risultati in base ad un nostro 
ordine particolare: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.query.QueryComparator; 

public class CognomeComparator implements 

QueryComparator<Giocatore> { 

public int compare(Giocatore argO, Giocatore arg1) { 
String cognomeA=arg0.getCognomeO; 
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String cognomeB=arg1 .getCognome(); 

int result = cognomeA.compareTo(cognomeB); 

return result; 



In questo caso CognomeComparator serve per ordinare i risulta- 
ti in base al cognome. Come abbiamo visto, le Native Query so- 
no uno strumento interessante per modellare le ricerche che 
dobbiamo effettuare su db4o. L'ultimo modo che possiamo uti- 
lizzare per fare delle query è SODA (Simple Object Data Access). 
Questa API ci permette di definire una serie di vincoli sulla query 
che dobbiamo effettuare, potendo anche inserire diversi AND o 
OR tra queste condizioni. Il suo livello di usabilità è inferiore ri- 
spetto alle Native Query perché, come vedremo il codice è leg- 
germente meno organizzato/pulito. 

package it.ioprogrammo.librodb.db4o; 



import com.db4o.Db4o; 



import com.db4o.0bjectSet; 
import com.db4o.query.Constraint; 
import com.db4o.query.Query; 

public class SODA { 

public static void main(String a[]) { 

ObjectContainer db=Db4o.openFile("db4o.db"); 



System.out.printlnfSelezione di tutti gli oggetti" 
Query query=db.query(); 
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ObjectSet result=query.execute(); 
while(result.hasNext()) { 

System. out.println(result.nextO); 

} 

System. out.println("Selezione di tutti gli oggetti con età uguale a 29"); 
query=db.query(); 
query.constrain(Giocatore.class); 
query.descend("eta").constrain(new lnteger(29)); 
result=query.execute(); 
while(result.hasNext()) { 

System. out.println(result.next()); 

} 

System.out.println("Selezione di tutti gli oggetti con età uguale a 29 

e nome uguale a Francesco"); 

query=db.query(); 
query.constrain(Giocatore.class); 
Constraint constr=query.descend(" nome " ) 
.constrain(" Francesco"); 
query.descend(" età") 
.constrain(new lnteger(29)).and(constr); 
result=query.execute(); 
while(result.hasNext()) { 

System. out.println(result.next()); 

} 

} 

} 

In questo caso le query vengono fatte utilizzando la classe Query 
di db4o. Questa classe ci permette di definire una serie di vinco- 
li, modellati con la classe Constraint, che possiamo aggiungere 
a Query. Nel codice precedente abbiamo prima selezionato tut- 
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ti i giocatori, poi abbiamo selezionato quelli con età pari a 29, 
aggiungendo un Container. Infine abbiamo aggiunto due diver- 
si Constrainte li abbiamo messi in AND. Come API è leggermen- 
te meno usabile delle Native Query, anche se c'è da dire che 
permette di modellare dal punto di vista 00 una ricerca sul da- 
tabase e soprattutto è più performante. Infatti db4o cerca di tra- 
sformare le Native Query in chiamate SODA proprio per questo 
motivo. 

AGGIORNAMENTO 
E CANCELLAZIONE 

Per completare la nostra panoramica sull'utilizzo classico che 
facciamo di un database, dobbiamo necessariamente vedere co- 
me poter aggiornare e/o cancellare un entry. Per quanto riguar- 
da la modifica, in un database relazionale avremmo costruito 
un stringa SQL. In questo caso dobbiamo modificare l'oggetto che 
riusciamo a reperire dal database 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 

import com.db4o.ObjectContainer; 

import com.db4o.0bjectSet; 

public class Modifica { 

public static void main(String a[]) { 

ObjectContainer db=Db4o.openFile("db4o.db"); 
Giocatore giocatore; 
giocatore=new Giocatore(); 
giocatore.setNome(" Francesco"); 
giocatore.setCognome("Totti"); 
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giocatore=(Giocatore)result.next(); 
//MODIFICA 

giocatore.setlngaggio(30000); 

db.set(giocatore); 

db.close(); 

} 



} 



Chiaramente la modifica può essere fatta su un oggetto che è sta- 
to recuperato nella sessione corrente, altrimenti il metodo set() 
inserirà un nuovo oggetto nel nostro database. La cancellazio- 
ne, invece viene eseguita attraverso il metodo deleteQ di Object- 
Container: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 
import com.db4o.ObjectContainer; 
import com.db4o.ObjectSet; 



public class Cancellazione { 

public static void main(String a[]) { 

ObjectContainer db=Db4o.openFile("db4o.db"); 
Giocatore giocatore; 
giocatore=new Giocatore(); 
giocatore.setNomef Francesco"); 
giocatore.setCognome( " Totti " ); 
ObjectSet result=db.get(giocatore); 
giocatore=(Giocatore)result.next(); 

//CANCELLAZIONE 
db.delete(giocatore); 
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db.close(); 

} 



RELAZIONI 

Parliamo ora di come poter collegare diverse tipologie di ogget- 
ti nel nostro database. Nel classico modello relazionale abbiamo 
la possibilità di avere le Foreìgn Key(FK), che ci permettono di ge- 
stire il collegamento tra diverse tabelle del nostro database. In 
db4o possiamo invece inserire degli oggetti come attributi del no- 
stro oggetto ed avere salvati su database entrambi, appoggian- 
doci quindi alla classica relazione 00 HAS-A. Cioè, se ho un og- 
getto A, che al suo interno gestisce un Vector di altri oggetti B, 
nel momento in cui vado a memorizzare l'oggetto/!, avrò co- 
me risultato nel database un oggetto A e tutti gli oggetti B in- 
seriti in A. Vediamo bene come funziona questa feature con un 
esempio. Prima di tutto iniziamo col definire una classe Squa- 
dra che gestisce un Vector di oggetti Giocatore che abbiamo pre- 
cedentemente definito ed utilizzato: 

package it.ioprogrammo.librodb.db4o; 

import java. util.Vector; 

public class Squadra { 
private String nome; 
private int punti; 
private int scudetti; 
private Vector giocatori; 



public String getNomeQ { 
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} 

public void setNome(String nome) { 
this.nome = nome; 

} 

public int getPuntiO { 
return punti; 

} 

public void setPunti(int punti) { 
this.punti = punti; 

} 

public int getScudetti() { 
return scudetti; 

} 

public void setScudetti(int scudetti) { 
this.scudetti = scudetti; 

} 

public Vector getGiocatori() { 
return giocatori; 

} 

public void setGiocatori(Vector giocatori) { 
this.giocatori = giocatori; 

} 

} 

Per utilizzare questa classe, dobbiamo inizializzarla, settando i 
vari attributi ed inserendo un Vector con qualche giocatore. Sue- 
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cessivamente la inseriamo nel nostro database db4o come ab- 
biamo fatto fino ad ora, ovvero utilizzando il metodo set() di 
ObjectContainer. 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 
import com.db4o.ObjectContainer; 
import com.db4o.0bjectSet; 
import java.util.Vector; 

public class InsertSquadra { 

public static void main(String a[]) { 

ObjectContainer db=Db4o.openFile("db4o.db"); 
Giocatore giocatorel, giocatore2; 
giocatorel =new Giocatore(); 
giocatorel .setNomef Francesco "); 
giocatorel .setCognome("Totti"); 
giocatorel .setEta(32); 
giocatorel .setlngaggio(20000); 
giocatorel .setRuolo(Ruolo.ATTACCANTE); 



giocatore2=new Giocatore(); 
giocatore2.setNome("Amantino"); 
giocatore2.setCognome(" Mancini "); 
giocatore2.setEta(28); 
giocatore2.setlngaggio(1 4000); 
giocatore2.setRuolo(Ruolo.CENTROCAMPISTA); 



Squadra squadra=new Squadra(); 
squadra. setNome(" Roma"); 
squadra. setPunti(20); 
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Vector giocatori=new Vector(); 
giocatori. add(giocatore1 ); 
giocatori. add(giocatore2); 
squadra. setGiocatori(giocatori); 



db.set(squadra); 
db.closeQ; 



} 



A questo punto avremo sul nostro database tre diversi oggetti 
memorizzati: una squadra e due giocatori. Le istanze di Gioca- 
tore che abbiamo memorizzate sono visibili anche con la classi- 
ca chiamata che ci permette di vedere tutte le istanze di una 
determinata classe. Quando invece andiamo a recuperare l'istanza 
di Squadra, avremo automaticamente settato il vettore con tut- 
ti i giocatori, come quando abbiamo inserito l'oggetto nel data- 
base. 

package it.ioprogrammo.librodb.db4o; 



import com.db4o.Db4o; 
import com.db4o.ObjectContainer; 
import com.db4o.ObjectSet; 
import java.util.Vector; 
public class ReadSquadra { 

public static void main(String a[]) { 

Squadra squadra=new Squadra(); 

ObjectContainer db=Db4o.openFile("db4o.db"); 

ObjectSet result=db.get(squadra); 

System.out.println("Squadre trovate: "+result.size()); 

Giocatore giocatore; 
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while(result.hasNext()) { 

squadra=(5quadra)result.next(); 
System.out.println("Nome: "+squadra.getNome()); 
System.out.println("Punti: " + squadra.getPunti()); 
System.out.println(" Giocatori: "); 
Vector giocatori=squadra.getGiocatori(); 
for(int i=0;i<giocatori.size();i++) { 

giocatore=(Giocatore)giocatori.elementAt(i); 

System.out.println(giocatore); 

} 

} 

db.closef); 

} 

} 

Eseguendo questo semplice programma avremo il seguente out- 
put, che ci segnala la presenza di una squadra con due giocato- 
ri: 

Squadre trovate: 1 
Nome: Roma 
Punti: 20 
Giocatori: 

Francesco Totti ATTACCANTE 
Amantino Mancini : CENTROCAMPISTA 

Chiaramente, il fatto di dover mantenere una consistenza di tut- 
ti i dati riferiti dall'oggetto Squadra, può essere un problema. 
Immaginiamo di avere una catena di oggetti che vengono rife- 
riti, nel momento in cui andiamo ad aggiornare qualcosa e a 
salvare, in teoria db4o dovrebbe andare a controllare tutti i cam- 
biamenti che sono stati fatti e aggiornare di conseguenza. 
Questo comportamento, se fosse settato per default rallente- 
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rebbe molto il nostro database. Proprio per questo motivo, per 
abilitare questo comportamento, ovvero avere un aggiornamen- 
to coerente per tutti gli oggetti che sono riferiti dall'oggetto che 
stiamo salvando, c'è una configurazione speciale da settare: 

Db4o.configure().objectClass(" it.ioprogrammo.librodb.Squadra"). 

cascadeOnUpdate(true); 

In questo modo, nel momento in cui andiamo a modificare uno 
degli oggetti Giocatore che la nostra istanza di Squadra gesti- 
sce, queste modifiche verranno riportate sul database. Lo stes- 
so discorso vale per quanto riguarda la cancellazione, ovvero 
quando stiamo cancellando una squadra, dobbiamo abilitare la 
cancellazione in cascata che ci permette con una sola cancella- 
zione di eliminare la squadra e tutti i giocatori ad essa associa- 
ti: 



Db4o.configure().objectClass(" it.ioprogrammo.librodb.Squadra"). 

cascadeOnDelete(true); 



INFRASTRUTTURA CLIENT/SERVER 

Abbiamo già visto come gestire la comunicazione client/server 
utilizzando le API di db4o. In questo paragrafo vedremo un'al- 
tra funzionalità che fornisce db4o per realizzare un'infrastrut- 
tura client/server. Utilizzando il metodo statico openServerQ di 
Db4o è possibile mettere in piedi un vero e proprio server che può 
essere raggiunto dai client con le giuste credenziali per potersi 
collegare al database ed effettuare le classiche operazioni. 
Oltre a questo è possibile aprire un'ulteriore porta di ascolto 
per il server, dove possono essere scambiati dei messaggi infor- 
mativi. Possiamo fare un parallelismo con i protocolli noti, ad 
esempio l'FTP (File Transfer Protocol). In questo protocollo ab- 
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biamo una porta che serve per l'invio dei veri e propri dati, tipi- 
camente la 20, e un'altra porta che serve per controllare la con- 
nessione, la 21 . In questo modo i dati che devono passare sul- 
la porta 20 vengono "orchestrati" dai comandi che passano sul- 
la porta 21 . In questo caso possiamo dire che il funzionamento 
è simile, praticamente abbiamo la connessione classica che ser- 
ve per effettuare le operazioni sul database. Esiste inoltre un'al- 
tra connessione che possiamo stabilire con il processo server 
per inviargli dei messaggi informativi, che possiamo usare ad 
esempio per avviare processi lato server come un backup dei 
dati. Vediamo prima di tutto di modellare il comando che vo- 
gliamo inviare al server con una semplice classe: 

package it.ioprogrammo.librodb.db4o; 

public class Comando { 
private String action; 
private String sender; 

public String getAction() { 
return action; 



public void setAction(String action) { 
this.action = action; 

} 

public String getSender() { 
return sender; 

} 

public void setSender(String sender) { 



this.sender = sender; 
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} 

Passiamo ora al server. In questo caso, per abilitare questo ca- 
nale di comunicazione supplementare, dobbiamo settare trami- 
te le API di db4o un oggetto come MessageRecipient, un'interfac- 
cia di db4o che definisce un solo metodo, processMessageQ, che 
viene richiamato per ogni messaggio che arriva sul server. 
All'interno di questo esempio, per semplicità, abbiamo messo 
nella stessa classe server e MessageRecipient: 

package it.ioprogrammo.librodb.db4o; 

import com.db4o.Db4o; 
import com.db4o.ObjectContainer; 
import com.db4o.ObjectServer; 
import com.db4o.messaging. MessageRecipient; 

public class ServerListener implements MessageRecipientf 

static ServerListener ServerListener; 

public ServerListener() { 
} 

public static void main(String a[]) { 
serverListener=new ServerListener(); 
String USERNAME="doc"; 
String PASSWORD="cod"; 
int PORTA=30330; 
boolean running=true; 

ObjectServer server=Db4o.openServer("db4o.db", PORTA); 
server.grantAccess(USERNAME,PASSWORD); 
server.ext().configure().clientServer().setMessageRecipient(serverListener); 
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try { 

while(running){ 
Thread.currentThread().sleep(5000); 



} catch (Exception e) { 
e.printStackTrace(); 

} 

} 



public void processMessage(ObjectContainer argO, Object arg1) { 
Comando comando=(Comando)arg1; 
System.out.println(" Ricevuto comando"); 
System.out.println(" Fonte: "+comando.getSender()); 
System.out.println(" Comando: "+comando.getAction()); 



Il server, in questo caso, ha dovuto inserire questa nuova featu- 
re utilizzando la configurazione client/server che si ottiene nel se- 
guente modo: 

server.extO.configureO.clientServerO 

Il metodo processMessageQ scrive semplicemente il comando 
appena questo arriva al server. Vediamo ora come inviare il mes- 
saggio informativo dal client: 

package it.ioprogrammo.librodb.db4o; 



import com.db4o.Db4o; 

import com.db4o.ObjectContainer; 

import com.db4o.0bjectSet; 
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import java.net.InetAddress; 

import java.net.UnknownHostException; 

public class ClientMessaging 

{ 

public static void main(String a[]) throws UnknownHostException 

{ 

String USERNAME="doc"; 
String PASSWORD="cod"; 
int PORTA=30330; 

Comando comando=new Cornando!); 
comando.setAction(" BACKUP"); 

comando.setSender(lnetAddress.getLocalHost().getHostName()); 
ObjectContainer 

client=Db4o.openClient("localhost",PORTA,USERNAME,PASSWORD); 

MessageSender messageSender = 

client.ext().configure().clientServer().getMessageSender(); 
messageSender.send(comando); 

client.closeO; 

} 

} 

Per inviare il messaggio abbiamo utilizzato la classe MessageSen- 
der e, una volta inizializzato l'oggetto Comando, lo abbiamo in- 
viato utilizzando il metodo send(). 

In questo modo possiamo creare una serie di comandi che pos- 
sono essere inviati al server, senza che il client rimanga colle- 
gato. 

Come citato nell'esempio, potremmo avviare un backup del no- 
stro database inviando un certo comando e avviando successi- 
vamente lato server un thread di gestione per il backup. 
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OBJECTMANAGER 

Per gestire db4o è possibile utilizzare un'applicazione interessan- 
te che è possibile scaricare direttamente dal sito ufficiale di 
db4o: ObjectManager. Si tratta praticamente di una semplice ap- 
plicazione scritta in Java che all'inizio ci offre la possibilità di 
collegarci al nostro database attraverso file oppure passando 
attraverso un server 




Password: f 



Figura 4.1: Avvio di ObjectManager 



Una volta che ci siamo collegati possiamo controllare tutto il 
nostro database, vedendo tutti gli oggetti che sono memoriz- 
zati. Questi sono suddivisi per il nome della classe (comprensi- 
vo di package) e possono essere fatte delle ricerche attraverso 
un inputbox dove possiamo inserire una query. 
Utilizzando questo tool è inoltre possible effettuare il backup 
del nostro database e avviare l'utility di deframmentazione. 
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Figura 4.2: ObjectManager in esecuzione 



Storca Classe* 


Ow 


Obietta 


t.iogf (jgrarorfK) .Èbrodb ,<fl)4rj .Comando 




* .irjprctgf «nriffffl.Bbrwtb .db4 e*. -Giocatore 




(C.ir^irDq/afrrrnD.rrbrorJb .db4o,ftyglcj 




£ jDprogr-fljiHTW .bbrodb .dMo. Squadra 


] 





s 



REPLICA DEL DATABASE 

Un'altra interessante feature che viene fornita da db4o è quel- 
la relativa alla replicazione del nostro database. Il fatto di ave- 
re due differenti database da mantenere aggiornati è uno sce- 
nario che si presenta talvolta nello sviluppo di applicazioni. Db4o 
mette a disposizione una semplice ma potente API che ci permet- 
te di replicare il nostro database con poche righe di codice. 
La sincronizzazione del nostro database può avvenire in due 
modi differenti: 
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Sincronizzazione con database db4o esterno 
Sincronizzazione con database relazionale 



La prima modalità non fa altro che replicare il contenuto del no- 
stro database db4o in un altro database dello stesso tipo. 



I libri di ioPROGRAMMO/Java e Database 



147 



JAVA 
E DATABASE 



ODBMS 



Capitolo 4 



La seconda modalità, invece, molto interessante, è quella rela- 
tiva alla replicazione del db4o con un database relazionale. 
Questa feature viene fornita utilizzando Hibernate, grazie al qua- 
le vengono mappati tutti gli oggetti in una tabella relazionale. 
L'utilità della prima e soprattutto della seconda tipologia di sin- 
cronizzazione può essere trovata in molti scenari, ad esempio 
possiamo immaginare di avere due diversi livelli di accesso al 
database della nostra applicazione, differenziando tra un data- 
base di backend e uno di frontend. 



148 



I libri di ioPROGRAMMo/Java e Database 



Capitolo 5 



ALTRE TECNOLOGIE 



JAVA 

E DATABASE 



ALTRE TECNOLOGIE 



In questo libro non possiamo sicuramente sviscerare tutte le 
possibili tecnologie che è possibile utilizzare in Java per dialo- 
gare con il database. Proprio per questo motivo ora faremo un 
veloce riassunto di argomenti che non sono stati approfonditi ma 
che comunque meritano di essere visti e presi in considerazio- 
ne quando affrontiamo decisioni riguardanti quale tecnologia 
utilizzare. 

JDO 

JDO (Java Data Objects) è una specifica venuta fuori dal Java 
Community Process (JCP), che cerca di definire una maniera 
standard per gestire le informazioni presenti sul database trami- 
te Java. A rappresentare le tabelle del nostro database sono del- 
le semplici classi Java, come ne abbiamo viste nel corso di que- 
sto libro, che non devono implementare nessuna interfaccia par- 
ticolare. La connessione tra queste classi e database è rappre- 
sentata da file di configurazione XML che definiscono tutto. 
Ci sono diverse versioni della specifica JDO, come riportato di se- 
guito 

• JDO 1 .0: JSR 12 — http://www.jcp.org/en/jsr/detail?id= 12 

• JDO 2.0: JSR 243 - http://www.jcp.org/en/jsr/detail?id=243 

• JDO 2.1: http://db.apache.org/jdo 

Le idee che sono presenti in JDO sono abbastanza simili a quel- 
le di vari altri framework, d'altronde la prima specifica pubbli- 
ca di JDO risale al 2002. Esistono diverse implementazioni del- 
la API JDO che possiamo utilizzare: 
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• JPOX: Implementazione di riferimento per JDO - 
h ttp://www.jpox. org 

• Kodo: Supporta JDO 2.0 (versione solo commerciale) - 
http://www.bea.com/kodo 

• OJB: ObjectRelationaIBridge di Apache - http://db.apache.org/ojb 

• Speedo Implementazione JDO 1 .0.1 -http://speedo.objectweb.org 

• TJDO: TriActive JDO - http://tjdo.sourceforge.net 

JPA 

JPA (Java Persistence API) nasce come "costola" della JSR 220, de- 
finita per la versione 3.0 degli EJB. Anche questa è una specifi- 
ca, come JDO, quindi può essere implementata o meno. Ma vi- 
sto il suo collegamento con la nuova versione di EJB e soprattut- 
to il fatto che sia stata definita proprio per creare una nuova 
API utilizzata in diversi ambiti per gestire le informazioni sul da- 
tabase, in breve tempo molti progetti opensource hanno incomin- 
ciato a sviluppare un'implementazione di questa API. Il funzio- 
namento è il solito, una classe POJO (Plain Old Java Object, ov- 
vero quello che abbiamo sempre utilizzato nei vari progetti ana- 
lizzati in questo libro) e una configurazione di mapping. L'interessante 
novità è che questa API si appoggia molto alle Annotations (in- 
trodotte in Java 5), permettendo quindi la definizione del map- 
ping all'interno della stessa classe (che può essere visto come un 
bene o come un male, dipende dai punti di vista). Le implemen- 
tazioni di questa API sono svariate: 

• Hibernate: http://www.hibernate.org 

• TopLink Essentials: 

http://www.orade.com/technology/produds/ias/toplink/jpa/indexIitml 

• Castor: http://www.castor.org 

• JPOX: http://www.jpox.org 

• GlassFish: 
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https://glassfish.dev.java.net/downloads/persistence/JavaPersistence.ht 
mi 

• OpenJPA: http://openjpa.apache.org 

In questo libro non è stato approfondito il mondo relativo agli 
Entity Bean, più che altro perché sono un argomento da affron- 
tare in uno scenario differente ed approfondito. C'è da dire che 
JPA è il motore di persistenza di EJB3, quindi approfondire que- 
sta API può essere sicuramente buono perchè possiamo trovar- 
ci a lavorare con diverse librerie, su diversi fronti, ma comun- 
que già siamo a conoscenza delle direttive fondamentali che 
vengono definite attraverso questa specifica. 



CONCLUSIONI 

Senza dilungarci troppo, dobbiamo sicuramente dire che esistono 
tanti progetti che possiamo utilizzare nel nostro programma Java 
per dialogare con un database. Non esiste di sicuro il "migliore", 
però quando dobbiamo decidere quale tecnologia utilizzare è giusto 




vedere anche le persone che seguono questo progetto. Ad esempio 
è poco furbo utilizzare dei progetti che sembrano abbandonati dai 
loro sviluppatori (ce ne sono tanti), anche perché se troviamo un 
problema all'interno di questo progetto dobbiamo rimboccarci le 
maniche e trovare da soli il bug. Questo non è l'unico metro di giu- 
dizio per un progetto opensource che possiamo utilizzare, ma è si- 
curamente uno dei suoi punti fondamentali. Altri progetti, che sep- 
pur validi, non hanno trovato spazio all'interno di questo libro sono 
i seguenti: 

• Cayenne: http://cayenne.apache.org 

• Torque: http://db.apache.org/torque 
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